Create Aria Agent Cloud Session for an Agent

Create a session bound to an agent. Sessions accumulate turns, items, memory fragments, and subagent state across their lifetime. Post events to a session to run a turn.

Endpoint

POST /v1/agents/sessions

Authentication

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

Request body

string

required

Identifier of the agent to bind this session to.

object

Free-form metadata stored with the session.

Response

string

Session identifier.

string

Always agent.session.

string

Bound agent identifier.

string

Session status, typically active.

object

Metadata provided at creation.

integer

Unix seconds.

Example

curl -X POST https://agent.example.com/v1/agents/sessions \
  -H "Authorization: Bearer $ARIA_AGENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"agent_id": "ag_0198a...", "metadata": {"user_id": "u_42"}}'

{
  "id": "sess_0198c...",
  "object": "agent.session",
  "agent_id": "ag_0198a...",
  "status": "active",
  "metadata": {"user_id": "u_42"},
  "created_at": 1735000000
}

PIN API

ROUTER API

AGENT API

Create Aria Agent Cloud Session for an Agent

Endpoint

Authentication

Request body

Response

Example

​Endpoint

​Authentication

​Request body

​Response

​Example

Endpoint

Authentication

Request body

Response

Example