List runs

GET

/api/v2/orchestrations/runs

SynapseOrch Cloud only. The workspace's recent runs, newest first, by status or orchestration. Runs of the AI Builder's own orchestration, and of orchestrations deleted since, are left out, and so is a nested run — it is part of the run that started it. queued is a run waiting for a slot in the plan's runs at once, with its queue_position. A self-hosted install lists runs at /api/v1.

Authorization

apiKey

headerAuthorizationBearer <token>

An API key, sk-syn- and 32 characters. On SynapseOrch Cloud an owner or admin makes it under Settings → Developer; on a self-hosted install, under Settings → API Keys.

Query Parameters

limit?integer

How many runs, 1 to 200.

Range1 <= value <= 200

Default20

status?|

Only runs with this status.

orchestration_id?|

Only this orchestration's runs.

Response Body

The runs.

application/json

response

[index: integer]?

Cloud only

curl -X GET "https://api.synapseorch.com/api/v2/orchestrations/runs" \  -H "Authorization: Bearer sk-syn-..."

[  {    "run_id": "run_01a10843ee6d704bbccfb11933a861d1",    "orchestration_id": "orch_01a1084a3b5c7d9e1f2a4b6c8d0e2f4a",    "status": "paused",    "started_at": "2026-10-04T17:58:40Z",    "ended_at": null,    "session_id": null,    "current_step_id": "approve",    "steps_completed": 2,    "last_step_name": "Check supplier",    "waiting_for_human": true,    "total_cost_usd": 0.0001,    "error": null  }]