API Reference
Hanzo Tasks API
Hanzo Tasks — the durable workflow/activity engine (event-sourced,
Hanzo Tasks — the durable workflow/activity engine (event-sourced,
Hanzo Tasks API · Guide & examples → · All API references →
| Base URL | https://api.hanzo.ai |
| Version | 1.0.0 |
| Operations | 8 |
| Guide | Hanzo Tasks 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://api.hanzo.aiEndpoints
System
| Method | Endpoint | Description |
|---|---|---|
GET | /v1/tasks/health | Liveness probe |
GET | /v1/tasks/settings | Capability flags (open bootstrap) |
GET | /v1/tasks/cluster | Cluster status (open probe) |
GET | /v1/tasks/cluster/health | Cluster health (open probe) |
Tasks
| Method | Endpoint | Description |
|---|---|---|
POST | /v1/tasks/mcp | Tasks MCP tool surface (JSON-RPC, identity-gated) |
GET | /v1/tasks/events | Realtime event stream (SSE, identity-gated) |
GET | /v1/tasks/{resource} | Engine JSON API (namespaces, workflows, activities, …), identity-gated |
POST | /v1/tasks/{resource} | Engine JSON API write (identity-gated) |
How is this guide?