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 turn objects.
curl https://agent.example.com/v1/agents/sessions/sess_01J5X8/turns \
-H "Authorization: Bearer <api-key>"
{
"object": "list",
"data": [
{
"id": "turn_01C",
"session_id": "sess_01J5X8",
"status": "completed",
"created_at": "2024-06-01T12:30:00Z"
}
]
}
Events & Turns
List Agent Turns
Fetch completed turns for an agent session. Each turn groups one full user-input to model-response cycle.
curl https://agent.example.com/v1/agents/sessions/sess_01J5X8/turns \
-H "Authorization: Bearer <api-key>"
{
"object": "list",
"data": [
{
"id": "turn_01C",
"session_id": "sess_01J5X8",
"status": "completed",
"created_at": "2024-06-01T12:30:00Z"
}
]
}
A turn represents one complete interaction cycle in a session: the user input, any tool calls, and the final model response. Use this endpoint to list all completed turns for a given session.
Was this page helpful?