List Aria Agent Cloud Sessions

List sessions. Optionally filter to sessions bound to a specific agent. Pagination is cursor-based using after and limit, matching the OpenAI Agents SDK.

Endpoint

GET /v1/agents/sessions

Authentication

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

Query parameters

string

Filter to sessions bound to one agent.

integer

Maximum number of sessions to return.

string

Cursor: session identifier to page after.

Response

string

Always list.

array

Array of session objects (see Get Session).

Example

curl "https://agent.example.com/v1/agents/sessions?agent_id=ag_0198a...&limit=20" \
  -H "Authorization: Bearer $ARIA_AGENT_KEY"

{
  "object": "list",
  "data": [
    {
      "id": "sess_0198c...",
      "object": "agent.session",
      "agent_id": "ag_0198a...",
      "status": "active",
      "created_at": 1735000000
    }
  ]
}

PIN API

ROUTER API

AGENT API

List Aria Agent Cloud Sessions

Endpoint

Authentication

Query parameters

Response

Example

​Endpoint

​Authentication

​Query parameters

​Response

​Example

Endpoint

Authentication

Query parameters

Response

Example