Hanzo Agents API

Per-org autonomous agent definitions, runs, and the live session control plane (hanzoai/cloud clients/agents).

Hanzo Agents API · Guide & examples → · All API references →

Authentication

All Hanzo APIs share one bearer credential and common error and pagination conventions. See API conventions.

curl -H "Authorization: Bearer $HANZO_API_KEY" https://api.hanzo.ai

Method	Endpoint	Description
`GET`	`/v1/agents`	List agents for the org.
`POST`	`/v1/agents`	Create an agent.
`GET`	`/v1/agents/{ref}`	Agent detail plus recent runs.
`PATCH`	`/v1/agents/{ref}`	Update an agent.
`DELETE`	`/v1/agents/{ref}`	Delete an agent and its runs.
`POST`	`/v1/agents/{ref}/run`	Run the agent.
`GET`	`/v1/agents/{ref}/runs`	Run history for the agent.

Method	Endpoint	Description
`GET`	`/v1/agents/metrics`	Invocations-over-time histogram for the org's Agents dashboard.
`GET`	`/v1/agents/activity`	Org-wide recent-activity feed.

Method	Endpoint	Description
`GET`	`/v1/agents/sessions`	List live sessions.
`POST`	`/v1/agents/sessions`	Register a live session.
`GET`	`/v1/agents/sessions/stream`	SSE feed of live session and event updates (rides ZAP).
`GET`	`/v1/agents/sessions/{id}`	Session detail plus direct children and recent events.
`PATCH`	`/v1/agents/sessions/{id}`	Update session status or title.
`GET`	`/v1/agents/sessions/{id}/tree`	The full subagent-flow graph rooted at this session.
`POST`	`/v1/agents/sessions/{id}/events`	Append an event to a session's ordered log.
`POST`	`/v1/agents/sessions/{id}/pause`	Pause a session (control command).
`POST`	`/v1/agents/sessions/{id}/resume`	Resume a session (control command).
`POST`	`/v1/agents/sessions/{id}/stop`	Stop a session (control command).
`POST`	`/v1/agents/sessions/{id}/message`	Send a message to a session (control command).