List agent sessions

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

[
  {
    "session_path": "/sandboxes/abc123/agent-sessions/session-789",
    "session_name": "Data Analysis Session",
    "root_session_path": "/sandboxes/abc123/agent-sessions/session-789",
    "root_session_name": "Data Analysis Session",
    "is_subagent": false,
    "session_depth": 0,
    "agent_id": "agent-456",
    "child_count": 2,
    "first_timestamp": "2024-04-20T14:22:00Z",
    "last_timestamp": "2024-04-20T15:10:00Z",
    "event_count": 35,
    "model": "claude-v1.3",
    "total_input_tokens": 1200,
    "total_output_tokens": 1500,
    "cwd": "/home/user/projects/data-analysis",
    "git_branch": "feature/data-insights",
    "harness_name": "python-3.9",
    "total_cache_creation_tokens": 300,
    "total_cache_read_tokens": 450,
    "first_user_text": "Analyze the quarterly sales data for trends"
  }
]

List all Claude agent sessions for a sandbox, ordered by most recent first.

Authentication

AuthorizationBearer

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

Path parameters

sandbox_idstringRequired

Query parameters

sincedatetime or nullOptional

Only return sessions with activity at or after this timestamp

include_subagentsbooleanOptionalDefaults to false

Include child/subagent sessions in addition to root sessions

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

child_countinteger

first_timestampdatetime

last_timestampdatetime

event_countinteger

modelstring

total_input_tokensinteger

total_output_tokensinteger

cwdstring

git_branchstring

harness_namestring

total_cache_creation_tokensinteger

total_cache_read_tokensinteger

first_user_textstring

Errors

401

Unauthorized Error

404

Not Found Error

422

Unprocessable Entity Error