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. Used for deployed-app (Runs API), AI Gateway, traces collector, and management API requests. 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"
}
}