Endpoint
Authentication
Pass one ofAuthorization: Bearer <api-key> or Authorization: ApiKey <key>.
Path Parameters
string
required
The agent session identifier.
Response
string
Always
list.array
Array of item objects in the session.
curl https://agent.example.com/v1/agents/sessions/sess_01J5X8/items \
-H "Authorization: Bearer <api-key>"
{
"object": "list",
"data": [
{
"id": "msg_01A",
"role": "user",
"content": "Hello"
},
{
"id": "msg_01B",
"role": "assistant",
"content": "Hi there"
}
]
}
Events & Turns
List Session Items
Retrieve every raw item inside an agent session, including messages, tool calls, and tool outputs, as a paginated list.
curl https://agent.example.com/v1/agents/sessions/sess_01J5X8/items \
-H "Authorization: Bearer <api-key>"
{
"object": "list",
"data": [
{
"id": "msg_01A",
"role": "user",
"content": "Hello"
},
{
"id": "msg_01B",
"role": "assistant",
"content": "Hi there"
}
]
}
This endpoint returns all raw items stored in a session. Items are the low-level building blocks: user messages, assistant messages, tool call requests, and tool outputs.
Was this page helpful?