Skip to main content
GET
/
v1
/
agents
/
sessions
/
{sessionId}
/
turns
/
{turnId}
/
events
List events for a turn
curl --request GET \
  --url {scheme}://{gatewayBaseURL}/{tenantName}/v1/agents/sessions/{sessionId}/turns/{turnId}/events \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "type": "model.message",
      "id": "<string>",
      "thread_id": "<string>",
      "created_at": "<string>",
      "content": "<string>",
      "name": "<string>",
      "refusal": "<string>",
      "reasoning_content": "<string>",
      "tool_calls": [
        {
          "id": "<string>",
          "type": "function",
          "function": {
            "name": "<string>",
            "arguments": "<string>"
          },
          "tool_info": {
            "type": "truefoundry-system",
            "name": "<string>"
          },
          "provider_specific_fields": {}
        }
      ],
      "usage": {
        "input_tokens": 1,
        "output_tokens": 1,
        "input_tokens_breakdown": {
          "harness": 1,
          "skills": 1,
          "instructions": 1,
          "tool_definitions": 1,
          "messages": 1
        },
        "cache_read_tokens": 1,
        "cache_write_tokens": 1
      }
    }
  ],
  "pagination": {
    "limit": 123,
    "next_page_token": "<string>",
    "previous_page_token": "<string>"
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

sessionId
string
required

Session identifier (.).

Minimum string length: 1
Example:

"01arz3ndektsv4rrffq69g5fav.g"

turnId
string
required

Turn identifier (..).

Minimum string length: 1
Example:

"01arz3ndektsv4rrffq69g5fav.g.ab12cd"

Query Parameters

page_token
string
limit
integer
default:25

Page size. Defaults to 25, max 25.

Required range: 1 <= x <= 25
order
enum<string>
default:asc

Sort events by creation time. Defaults to "asc".

Available options:
asc,
desc

Response

Paginated events.

data
object[]
required
pagination
object
required