Retrieve an Aria Agent Cloud Session by ID

Retrieve a session by identifier. The response includes the bound agent, status, metadata, and aggregate counts of turns, items, and subagents.

Endpoint

GET /v1/agents/sessions/{session_id}

Authentication

Authorization: Bearer <api_key> or Authorization: ApiKey <api_key>.

Path parameters

string

required

Session identifier.

Response

string

Session identifier.

string

Always agent.session.

string

Bound agent identifier.

string

Session status.

object

Free-form metadata.

object

Aggregate counts of turns, items, and subagents.

integer

Unix seconds.

Example

curl https://agent.example.com/v1/agents/sessions/sess_0198c... \
  -H "Authorization: Bearer $ARIA_AGENT_KEY"

{
  "id": "sess_0198c...",
  "object": "agent.session",
  "agent_id": "ag_0198a...",
  "status": "active",
  "metadata": {"user_id": "u_42"},
  "counts": {"turns": 3, "items": 12, "subagents": 0},
  "created_at": 1735000000
}

PIN API

ROUTER API

AGENT API

Retrieve an Aria Agent Cloud Session by ID

Endpoint

Authentication

Path parameters

Response

Example

​Endpoint

​Authentication

​Path parameters

​Response

​Example

Endpoint

Authentication

Path parameters

Response

Example