Skip to main content
GET
/
api
/
v1
/
user-sessions
/
{user_session_id}
/
agent-sessions
/
{agent_session_id}
Get Agent Session Detail
curl --request GET \
  --url https://api.example.com/api/v1/user-sessions/{user_session_id}/agent-sessions/{agent_session_id} \
  --header 'Authorization: Bearer <token>'
{
  "session": {
    "session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "session_type": "CODE",
    "connection_status": "CONNECTED",
    "work_status": "IDLE",
    "kind": "agent_session",
    "user_session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "parent_session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "daemon_version": "<string>",
    "metadata": {},
    "settings": {
      "code": {
        "mode": "agent",
        "default_provider": "<string>",
        "providers": {
          "claude_code": {
            "model": "haiku"
          },
          "codex": {
            "model": "gpt-5.1-codex-max",
            "thinking": "low"
          }
        }
      },
      "voice": {
        "language": "<string>"
      }
    }
  },
  "child_sessions": [
    {
      "session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "session_type": "CODE",
      "connection_status": "CONNECTED",
      "work_status": "IDLE",
      "kind": "agent_session",
      "user_session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "parent_session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "daemon_version": "<string>",
      "metadata": {},
      "settings": {
        "code": {
          "mode": "agent",
          "default_provider": "<string>",
          "providers": {
            "claude_code": {
              "model": "haiku"
            },
            "codex": {
              "model": "gpt-5.1-codex-max",
              "thinking": "low"
            }
          }
        },
        "voice": {
          "language": "<string>"
        }
      }
    }
  ]
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
user_session_id
string
required
​
agent_session_id
string
required

Response

Successful Response

Detailed agent session with child sessions.

​
session
AgentSessionDescriptor · object
required

The agent session descriptor

​
child_sessions
AgentSessionDescriptor · object[]

Child agent sessions spawned from this session