Poll a run
Retrieve the current state and result of an agent run
Notes
- Poll with the
run_idreturned by Dispatch a run.statusprogressesqueued→running→completed/failed; theresultis populated oncestatusiscompleted. - To resume or tail the run as a live Server-Sent Events stream, send
Accept: text/event-stream. Usestarting_after(or theLast-Event-IDheader) to replay only events whoseseqis greater than a value you’ve already seen. See the Agent guide.
Authorizations
Path Parameters
Run ID returned by POST /v1/agent/runs
Query Parameters
SSE resume cursor (Accept: text/event-stream only). Replay events with seq strictly greater than this value. Equivalent to the Last-Event-ID header.
x >= 0Response
Current state of the agent run. With Accept: text/event-stream, resumes/tails the run as an SSE stream of AgentStreamEnvelope events (use starting_after or Last-Event-ID to resume); if the stream ends without an agent_result event, poll this endpoint with Accept: application/json for terminal status.
The run resource returned by dispatch (202) and poll (GET).
queued, running, completed, failed "agent.run"Final agent output. answer is markdown; cards reuse the sibling TakoCard.