Get agent session events

curl /sandboxes/sandbox_id/agent-sessions/session_name/events \
     -H "Authorization: Bearer <api_key>" \
     -H "Content-Type: application/json"

[
  {
    "session_path": "/sandboxes/abc123/agent-sessions/session-42",
    "session_name": "session-42",
    "root_session_path": "/sandboxes/abc123/agent-sessions/session-42",
    "root_session_name": "session-42",
    "is_subagent": false,
    "session_depth": 0,
    "agent_id": "agent-789",
    "timestamp": "2024-01-15T09:30:00Z",
    "event_type": "code_execution",
    "actor": "agent-789",
    "model": "gpt-4",
    "input_tokens": 150,
    "output_tokens": 300,
    "harness_name": "python-runner",
    "cwd": "/app/scripts",
    "body": "Executed script to process data input.",
    "cache_creation_input_tokens": 150,
    "cache_read_input_tokens": 0
  }
]

Return all trace events for a specific agent session, ordered by timestamp.

Authentication

AuthorizationBearer

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

Path parameters

sandbox_idstringRequired

session_namestringRequired

Query parameters

session_pathstring or nullOptional

Stable unique session path from the session list response. Use this to disambiguate duplicate session names.

include_descendantsbooleanOptionalDefaults to true

When true, include descendant subagent sessions under the requested session

limitintegerOptional<=2000Defaults to 500

Page size — number of events to return

offsetintegerOptional>=0Defaults to 0

Number of events to skip (for pagination)

sincedatetime or nullOptional

Only return events after this timestamp (exclusive). Applied before offset.

Response

Successful Response

session_pathstring

session_namestring

parent_session_pathstring or null

parent_session_namestring or null

root_session_pathstring

root_session_namestring

is_subagentboolean

session_depthinteger

agent_idstring or null

timestampdatetime

event_typestring

actorstring

modelstring

input_tokensinteger or null

output_tokensinteger or null

harness_namestring

cwdstring

bodystring

cache_creation_input_tokensinteger or null

cache_read_input_tokensinteger or null

Errors

401

Unauthorized Error

404

Not Found Error

422

Unprocessable Entity Error