CLIAgents
Agents
32 `hanzo` commands for Agents, each calling one operation on api.hanzo.ai.
Package agents is autonomous agents for your org: define them, run them, keep every run.
32 commands · API reference →
| Command | Calls | What it does |
|---|---|---|
hanzo agents run <ref> | POST /v1/agents/{ref}/run | Run one of your org's agents and get the recorded run back. |
hanzo agents runs <ref> | GET /v1/agents/{ref}/runs | Returns one agent's execution history, newest first — each run's input, its output or its error, and how long it took. |
hanzo agents get <ref> | GET /v1/agents/{ref} | Returns one agent with its system prompt and its 20 most recent runs. |
hanzo agents update <ref> | PATCH /v1/agents/{ref} | Changes an agent in place. |
hanzo agents rm <ref> | DELETE /v1/agents/{ref} | Removes an agent and every run recorded against it. |
hanzo agents activity | GET /v1/agents/activity | Serves the org-wide recent-activity feed. |
hanzo agents builds org get <org> <project> | GET /v1/agents/builds/{org}/{project} | Returns the readable build of one product: the agent session that produced it, turn by turn — the prompts, the… |
hanzo agents builds list | GET /v1/agents/builds | Returns the public index of every published build, most recently updated first, so a gallery can link straight to the… |
hanzo agents metrics | GET /v1/agents/metrics | Serves the invocations-over-time histogram for the org's Agents dashboard. |
hanzo agents runs-all | GET /v1/agents/runs | Returns the org's agent runs across EVERY agent, newest first — what ran here, for whom, on which model, how long it… |
hanzo agents sessions control <id> | GET /v1/agents/sessions/{id}/control | Returns the steering commands (pause/resume/stop/message) recorded against the caller's own session that are newer than… |
hanzo agents sessions events <id> | POST /v1/agents/sessions/{id}/events | Append one turn to a session's ordered log. |
hanzo agents sessions message <id> | POST /v1/agents/sessions/{id}/message | Send text into a running session. |
hanzo agents sessions pause <id> | POST /v1/agents/sessions/{id}/pause | Ask a running session to pause. |
hanzo agents sessions resume <id> | POST /v1/agents/sessions/{id}/resume | Ask a paused session to carry on. |
hanzo agents sessions stop <id> | POST /v1/agents/sessions/{id}/stop | Ask a session to stop for good. |
hanzo agents sessions tree <id> | GET /v1/agents/sessions/{id}/tree | Returns the subagent-flow graph rooted at this session: the session, its children, their children, each node carrying… |
hanzo agents sessions get <id> | GET /v1/agents/sessions/{id} | Returns one session with its direct child sessions and its 50 most recent events, oldest of those first. |
hanzo agents sessions update <id> | PATCH /v1/agents/sessions/{id} | Updates a session's surface-owned truth: its status, its title, the run-target it is dispatched to, and the product it… |
hanzo agents sessions stream | GET /v1/agents/sessions/stream | Live session and event updates for the caller's org, as Server-Sent Events. |
hanzo agents sessions list | GET /v1/agents/sessions | Returns the caller org's live sessions, newest first — each with its event count, its direct-child count and a one-line… |
hanzo agents sessions create | POST /v1/agents/sessions | Opens a live agent session in the caller's org — the row every surface (the CLI's outer agent, hanzo.bot, the console,… |
hanzo agents targets claim <id> | POST /v1/agents/targets/{id}/claim | ClaimRoutedRun is the machine's long poll for work: it authenticates the daemon, stamps the liveness the dispatch gate… |
hanzo agents targets key <id> | POST /v1/agents/targets/{id}/key | Mints (or rotates) the claim key a hanzo code --serve daemon presents to claim work for this machine, and returns it… |
hanzo agents targets runs report <id> <runId> | POST /v1/agents/targets/{id}/runs/{runId}/report | Completes a claimed run: it delivers the terminal result to the run's durable owner, which is what lets that workflow… |
hanzo agents targets get <id> | GET /v1/agents/targets/{id} | Returns one registered machine, with its live session load. |
hanzo agents targets update <id> | PATCH /v1/agents/targets/{id} | Updates one machine in place. |
hanzo agents targets rm <id> | DELETE /v1/agents/targets/{id} | Deregisters one machine. |
hanzo agents targets list | GET /v1/agents/targets | Returns every machine registered to the caller's org, newest first, each with its live session load. |
hanzo agents targets create | POST /v1/agents/targets | Registers a machine as an agent target, or re-links one that is already registered. |
hanzo agents list | GET /v1/agents | Returns every agent defined in the caller's org, each with the number of runs recorded against it. |
hanzo agents create | POST /v1/agents | Defines an agent in the caller's org: a model, a system prompt (instructions) and a set of tool names. |
How is this guide?