Hanzo AI

Bot

A bot doing your work on a real desktop, live, while you watch.

Also for this capability: API · CLI · SDKs

A bot doing your work on a real desktop, live, while you watch.

Base URLhttps://api.hanzo.ai
Operations3
AuthAuthorization: Bearer $HANZO_API_KEY

Specification

Specification pending — no HIP in hanzoai/hips declares capability: bot yet. What this capability serves is below, from the API document; what it is — the store it owns, how it meters, what it publishes — is written as a HIP under HIP-0139.

Four surfaces

SurfaceReaches this capability asCoverage
RESTbot at its own prefix3 operations
CLIhanzo bot …3 of 3
SDKBotApi in every published client3 methods
MCPtool bot on https://api.hanzo.ai/v1/mcp4 operations, 0 under the document's own id — ask describe for the rest

Quickstart

export HANZO_API_KEY=sk-...   # console.hanzo.ai → API keys

Then the first call — a read that needs nothing but the key. GET /v1/bot/runs, operation get_bot_runs:

hanzo bot runs list

Answers 200 with object — ok.

Endpoints

EndpointWhat it does
POST /v1/bot/runs/{runId}/stopStop terminates one of the caller org's own bot runs and reports its terminal state.
GET /v1/bot/runsList returns the caller org's live bot runs, read from the bot runtime and projected into the console contract with each run's live session URL…
POST /v1/bot/runsAnswers 501 to every call: launching a bot run is not implemented.

All Hanzo APIs · Interactive reference

How is this guide?