list_releases
List all releases of a workflow, newest first.
Parameters#
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
workflow_id | string | yes | The draft workflow id (agent_…) |
Returns#
json
{
"workflow_id": "agent_abc",
"production_release_id": "release_abc",
"releases": [
{
"id": "release_abc",
"name": "Enrich Contact",
"notes": "Switch to Fable 5",
"snapshot_id": "agent_snap_123",
"is_production": true,
"created_at": "2026-06-09T12:00:00Z"
}
],
"count": 1
}production_release_id is null when no release is promoted — run_workflow with target="production" will fail until one is.
Errors#
error_type | When |
|---|---|
auth_error | Missing / invalid API key |
not_found | Workflow id doesn’t exist or is outside your org |
See also#
create_release— add a new versionset_production_release— change which one is live