API Reference
Hanzo Operative API
Hanzo Operative is a computer-use agent that allows Claude to interact with
Hanzo Operative is a computer-use agent that allows Claude to interact with
Hanzo Operative API · Guide & examples → · All API references →
| Base URL | https://operative.hanzo.ai |
| Version | 1.0.0 |
| Operations | 13 |
| Guide | Hanzo Operative API guide |
Authentication
BearerAuth— HTTP bearer
All Hanzo APIs share one bearer credential and common error and pagination conventions. See API conventions.
curl -H "Authorization: Bearer $HANZO_API_KEY" https://operative.hanzo.aiEndpoints
Computer
| Method | Endpoint | Description |
|---|---|---|
GET | /v1/operative/sessions/{sessionId}/screenshot | Take a screenshot of the current desktop |
POST | /v1/operative/sessions/{sessionId}/computer | Execute a computer action |
Configuration
| Method | Endpoint | Description |
|---|---|---|
GET | /v1/operative/env-config.json | Get environment configuration |
GET | /health | Health check |
Sessions
| Method | Endpoint | Description |
|---|---|---|
GET | /v1/operative/sessions | List all active sessions |
POST | /v1/operative/sessions | Create a new operative session |
GET | /v1/operative/sessions/{sessionId} | Get session details |
DELETE | /v1/operative/sessions/{sessionId} | Terminate and delete a session |
POST | /v1/operative/sessions/{sessionId}/reset | Reset the session environment |
Tasks
| Method | Endpoint | Description |
|---|---|---|
GET | /v1/operative/sessions/{sessionId}/messages | Get conversation history for a session |
POST | /v1/operative/sessions/{sessionId}/messages | Send a message to the operative agent |
Tools
| Method | Endpoint | Description |
|---|---|---|
POST | /v1/operative/sessions/{sessionId}/bash | Execute a bash command |
POST | /v1/operative/sessions/{sessionId}/edit | Execute a file editing command |
How is this guide?