List runs

GET

/api/v1/orchestrations/runs

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. On SynapseOrch Cloud queued is a run waiting for a slot in the plan's runs at once, with its queue_position; a run accepted and not yet picked up reads running. See the Orchestrations API.

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; queued on SynapseOrch Cloud only.

orchestration_id?|

Only this orchestration's runs.

Response Body

The runs.

application/json

response

[index: integer]?

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

[  {    "run_id": "run_orch_k3j9x2a_1734567890123_4f2a9c",    "orchestration_id": "orch_k3j9x2a",    "status": "paused",    "started_at": "2026-09-16T10:00:00Z",    "ended_at": null,    "current_step_id": "step_approve",    "steps_completed": 2,    "last_step_name": "Write",    "waiting_for_human": true,    "total_cost_usd": 0.0031,    "error": null  }]