Runs

Answer a paused run as a stream

POST
/api/v1/orchestrations/runs/{run_id}/resume/stream

Resume with a stream of server-sent events instead of waiting. The request body is the same as resume, and the events are the same as run as a stream.

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.

run_id*string

The paused run.

application/json
  1. body

The answer to the question a paused run is asking.

response?|

Required: text, or an object keyed by the question's field names. A Human step with no fields holds a plain answer as its text, so "yes" and {"response": "yes"} store the same thing. An answer that says nothing — blank text, or {} — is a 422. A tool confirmation takes {"approve": true}, or false to refuse.

question_id?|null

Response Body

A stream of server-sent events.

response?stringtext/event-stream
curl -X POST "https://api.synapseorch.com/api/v1/orchestrations/runs/run_01a10a1553d57036bae3d17421a4ba16/resume/stream" \  -H "Authorization: Bearer sk-syn-..." \  -H "Content-Type: application/json" \  -d '{    "response": {      "decision": "approve"    }  }'
data: {"type": "step_start", "orch_step_id": "step_publish", "step_name": "Publish", "step_type": "agent"}data: {"type": "step_complete", "orch_step_id": "step_publish", "step_name": "Publish", "duration_seconds": 3.2}data: {"type": "orchestration_complete", "run_id": "run_orch_k3j9x2a_1734567890123_4f2a9c", "status": "completed", "final_state": {"decision": "approve"}}data: {"type": "done"}