Fetch or resume an agent response
GET/agent/:id/responses/:response_id
Re-opens a previously-started response. Behaviour depends on starting_after:
- Resume / replay (SSE): with
starting_after=<sequence_number>(andAccept: text/event-stream), the platform replays every event whosesequence_number > starting_afterand, if the response is still in progress, continues live as new events arrive. Re-resuming yields the samesequence_numberfor the same logical event, so the cursor is stable.starting_afterpast the last event closes the stream immediately with no events (a lightweight "no new events" probe). - Terminal metadata read (JSON): when
starting_afteris absent and the response has already terminated, the platform returns the cached terminal OpenAIResponseobject as JSON.
See the Responses resume guide for the resume protocol and the full SSE taxonomy.
Request
Responses
- 200
- 400
- 401
- 404
- 410
When resuming/replaying: an SSE stream of the remaining events. When reading a terminated response without starting_after: the terminal OpenAI Response object as JSON.
starting_after is invalid (negative, non-integer, or out of range).
Authentication required
The response exists but does not belong to this agent (id).
The response is absent from both the hot cache and the durable store, or its durable record survives but the underlying event stream has been evicted.