Hanzo Automations API

Connectors + Automations engine for Hanzo Cloud — the /v1/automations/*

Hanzo Automations API · 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/automations/flows`	List flows
`POST`	`/v1/automations/flows`	Create a flow (with an initial draft version)
`GET`	`/v1/automations/flows/{id}`	Get a flow and its latest version
`PATCH`	`/v1/automations/flows/{id}`	Update flow metadata
`DELETE`	`/v1/automations/flows/{id}`	Delete a flow (with its versions and runs)
`GET`	`/v1/automations/flows/{id}/versions`	List a flow's versions
`POST`	`/v1/automations/flows/{id}/versions`	Create a draft version
`POST`	`/v1/automations/flows/{id}/operations`	Apply a flow operation to the latest version
`POST`	`/v1/automations/flows/{id}/enable`	Enable a flow (POLLING triggers create a schedule)
`POST`	`/v1/automations/flows/{id}/disable`	Disable a flow (removes any POLLING schedule)

Method	Endpoint	Description
`POST`	`/v1/automations/mcp`	JSON-RPC 2.0 tool surface over connector actions

Method	Endpoint	Description
`GET`	`/v1/automations/pieces`	List the connector/piece catalogue

Method	Endpoint	Description
`POST`	`/v1/automations/flows/{id}/run`	Start a durable run of a flow's runnable version
`GET`	`/v1/automations/runs`	List runs
`GET`	`/v1/automations/runs/{id}`	Get a run (non-terminal status is refreshed from the engine)
`POST`	`/v1/automations/runs/{id}/resume`	Resume a paused run