Commands
The full renza command tree, generated from the CLI itself. Commands that wrap one API operation link to that operation's reference page — the parameter tables and the CLI/curl/SDK examples live there. Global flags (--json, --api-key, -q, -y) are covered in Output & exit codes.
Agents: renza commands prints this tree as JSON.
Top-level commands
| Command | What it does |
|---|---|
renza login--api-key <key>--api-url <url> | Authorize this CLI in your browser (or pass --api-key for headless/CI) |
renza logout | Remove stored credentials from ~/.renza/config.json |
renza whoami | Where the CLI will send requests (no secret printed) |
renza me | Resolve the current context (actor, org, mode) Reference → |
renza doctor | Diagnose setup: credentials, connectivity, and identity Reference → |
renza describe <id> | Rich summary of a resource — a deck composes its versions, shares, grants, open comments |
renza commands | Print the full command tree as JSON (capability discovery for agents) |
renza guide | Print the slide contract — how to author an HTML deck that renders well on Renza |
renza check [path] | Validate a deck against the slide contract without publishing (the author loop) |
renza init--force | Teach your AI tools the Renza slide contract (writes a Claude skill / Cursor rules / AGENTS.md) |
renza update | Update the renza CLI to the latest version |
renza publish [path]--title <title>--external-id <id>--new--no-write--no-open | Publish an HTML deck to a live link — finds the deck in the current folder if no path given Reference → |
renza import <file>--external-id <id>--title <title> | Import an HTML deck → creates a deck + artifact (+ slides) Reference → |
renza slides--artifact <id> | List an artifact's slides Reference → |
renza memberships | List the active org's members Reference → |
renza decks
| Command | What it does |
|---|---|
renza decks list--status <status>--limit <n>--cursor <cursor>--order <order> | List decks Reference → |
renza decks get <id> | Retrieve a deck Reference → |
renza decks create--title <title>--status <status>--share-mode <mode>--external-id <id> | Create or upsert a deck Reference → |
renza decks update <id>--title <title>--status <status>--share-mode <mode>--current-artifact <art> | Update a deck Reference → |
renza decks rollback <id> <artifact> | Point the deck at a prior version (must be one of its own artifacts) |
renza decks pull <id>--out <file>--stdout | Fetch a deck's current HTML + anchor ids for editing (the BYO-AI round-trip) |
renza decks versions <id>--limit <n>--cursor <cursor> | List a deck's artifact versions (newest first) |
renza decks trash <id> | Move a deck to the trash (soft delete) Reference → |
renza decks restore <id> | Restore a trashed deck |
renza decks delete <id> | Permanently delete an already-trashed deck (irreversible) |
renza decks list-trash | List trashed decks |
renza decks move <id> <folder> | Move a deck into a folder (folder = id or 'root') |
renza folders
| Command | What it does |
|---|---|
renza folders list--parent <id>--trashed | List folders Reference → |
renza folders create <name>--parent <id> | Create a folder Reference → |
renza folders get <id> | Retrieve a folder Reference → |
renza folders rename <id> <name> | Update a folder Reference → |
renza folders move <id> <parent> | Move a folder under another (parent = id or 'root') |
renza folders trash <id> | Trash or permanently delete a folder Reference → |
renza folders restore <id> | |
renza folders delete <id> | Permanently delete an already-trashed folder + contents (irreversible) |
renza imports
| Command | What it does |
|---|---|
renza imports list--status <status>--limit <n>--cursor <cursor> | List imports Reference → |
renza imports get <id> | Retrieve an import Reference → |
renza artifacts
| Command | What it does |
|---|---|
renza artifacts list--deck <deck>--limit <n>--cursor <cursor> | List artifacts Reference → |
renza artifacts get <id> | Retrieve an artifact Reference → |
renza artifacts content <id> | Fetch an artifact's stored entry HTML (the BYO-AI round-trip) Reference → |
renza keys
| Command | What it does |
|---|---|
renza keys create <name>--service | Create an API key Reference → |
renza keys list | List API keys Reference → |
renza keys revoke <id> | Revoke an API key Reference → |
renza orgs
| Command | What it does |
|---|---|
renza orgs list | List orgs Reference → |
renza orgs get <id> | Retrieve an org Reference → |
renza orgs update <id>--name <name> | Update an org Reference → |
renza shares
| Command | What it does |
|---|---|
renza shares create <deck>--mode <mode> | Share a deck Reference → |
renza shares list <deck> | List a deck's shares Reference → |
renza shares revoke <id> | Revoke a share Reference → |
renza shares resolve <token> | Public: resolve a share token to deck info Reference → |
renza comments
| Command | What it does |
|---|---|
renza comments list--deck <id>--slide-index <n>--resolved <bool>--parent <id>--limit <n>--cursor <cursor>--order <order> | List comments Reference → |
renza comments get <id> | Retrieve a comment Reference → |
renza comments create <deck>--body <text>--slide-index <n>--x <fraction>--y <fraction>--external-id <id> | Create a thread root anchored to a slide point Reference → |
renza comments reply <id> <body> | Reply to a comment thread |
renza comments resolve <id> | |
renza comments reopen <id> | |
renza comments update <id>--body <text> | Update a comment Reference → |
renza comments delete <id> | Delete a comment (a thread root takes its replies) Reference → |
renza grants
| Command | What it does |
|---|---|
renza grants list--resource <id>--resource-type <type>--principal <id>--limit <n>--cursor <cursor> | List grants Reference → |
renza grants create <resource> <principal>--role <role>--resource-type <type>--principal-type <type> | Grant a principal a role on a deck/folder Reference → |
renza grants get <id> | Retrieve a grant Reference → |
renza grants revoke <id> | Revoke a grant Reference → |