Runs
Stream run events (SSE)
Streams the run's events over Server-Sent Events in strict sequence order, starting from the beginning or from after_sequence. The stream closes after a terminal event (run.completed, run.failed, run.canceled). A : heartbeat comment is emitted every 15 seconds of inactivity.
Authorization
accessKey AuthorizationBearer <token>
Organization or project Access Key created in the Dynamiq console. Valid only on synapse-served hosts: deployed app hostnames, knowledge base hostnames, the AI Gateway (router.*), and the traces collector (collector.*). Prefix dynamiq_acc_. NOT accepted by the management API (api.*). Send as Authorization: Bearer <access-key>.
In: header
Path Parameters
run_id*string
Run UUID.
Query Parameters
after_sequence?integer
Resume the stream after this sequence number (minimum 1).
Response Body
text/event-stream
application/json
application/json
application/json
curl -X GET "https://example.com/v1/runs/497f6eca-6276-4993-bfeb-53cbbbba6f08/stream""event: agent.reasoning.delta\ndata: {\"id\":\"d1a2...\",\"type\":\"agent.reasoning.delta\",\"sequence\":3,\"timestamp\":\"2026-06-10T09:15:24Z\",\"data\":{\"object\":\"agent.reasoning.delta\",\"delta\":\"The customer reports a duplicate charge...\",\"iteration\":1}}\n\nevent: run.completed\ndata: {\"id\":\"f5c6...\",\"type\":\"run.completed\",\"sequence\":9,\"timestamp\":\"2026-06-10T09:15:34Z\",\"data\":{\"id\":\"8c2c8e2e-...\",\"object\":\"run\",\"status\":\"completed\",\"output\":{\"category\":\"billing\"}}}\n"{
"error": {
"code": "bad_request",
"message": "Bad Request",
"details": {
"input": "cannot be blank"
}
}
}{
"error": {
"code": "unauthorized",
"message": "Unauthorized"
}
}{
"error": {
"code": "not_found",
"message": "Not Found"
}
}