List items for a specific root agent turn to verify messages, tool calls, and reasoning summaries.
Endpoint
GET /agents/sessions/{session_id}/turns/{turn_id}/items
Returns items for a specific root agent turn. Returns 200 on success. The query does not start a model, resume execution, or create resources.
Path parameterssession_idstring (required)Session ID, for example sess_xxxturn_id string (required)Public turn ID, for example turn_xxxThe path hierarchy must match. If the turn does not belong to the session, no data is returned.Query parameterslimitinteger (optional)Page size, range 1–100, default 20order string (optional)Sort direction, asc or desc, default descafter string (optional)The last_id from the previous page; the cursor item is excludedbefore is ignored and is not used for reverse pagination. Use order and after to page. | Request example |
Response fieldsList envelope:objectstringList object type, fixed as listdata array<Item>Items on this page; [] when emptyfirst_id string / nullFirst item ID on this page; null for an empty pagelast_id string / nullLast item ID on this page; null for an empty page; use it as afterhas_more booleanWhether the current scan direction has another pageEvery item has id, turn_id, and type. Business fields are at the top level. For item types and content parts, see List Items.Persisted items use final content. SSE item.added can show an in-progress item; an unfinished real-time item is not guaranteed to appear in the list. | Response example |
Error codes
| HTTP status | Error type / code | Solution |
|---|---|---|
400 | invalid_request_error / invalid_request_error | Fix limit and order as described in the query parameters; use the last_id returned by the previous page as after |
404 | not_found_error / not_found_error | Confirm that the session and turn exist in the same workspace, and use matching path levels |
502 | server_error / agents_api_upstream_unavailable | Retry later. If it keeps failing, submit a ticket with the x-request-id from the response headers |