v1

latestOpenAPI 3.0.02026-07-26492143.5 KB

Sessions

Retrieve session

Retrieve a session by ID, including its messages, current state, agent metadata, and participants.

get/sessions/{session_id}

Path parameters

session_idstring required

ID of the session to retrieve.

Response

The session.

queue_positioninteger nullable

Position in the per-agent queue. Populated only when the session is currently queued; otherwise null.

Example response

{
  "session": {
    "id": "sess_xYz789AbCd",
    "agent_id": "abc123DEFghiJKL",
    "messages": [
      {
        "id": "msg_a1b2c3",
        "role": "user",
        "content": "Research Acme Corp and draft a brief.",
        "created_at": "2026-05-15T14:32:00Z",
        "creator_id": "user_2b9d71f0"
      }
    ],
    "created_at": "2026-05-15T14:32:00Z",
    "state": "completed",
    "agent_name": "Sales research agent",
    "agent_team_id": "team_4f8c92ab",
    "agent_creator_user_id": "user_2b9d71f0",
    "usage": {
      "credit_cost": 12.5,
      "tool_credit_cost": 4,
      "flow_credit_cost": 1.5,
      "input_tokens": 18432,
      "output_tokens": 2043
    }
  }
}