Update an Aria Agent Cloud Session

Update a session’s status or metadata. Following the OpenAI beta convention, updates use POST and apply a partial patch: included fields are replaced, omitted fields are untouched.

Endpoint

POST /v1/agents/sessions/{session_id}

Authentication

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

Path parameters

string

required

Session identifier.

Request body

string

New session status, such as active or archived.

object

Replacement metadata object.

Response

Returns the full updated session (same shape as Get Session).

Example

curl -X POST https://agent.example.com/v1/agents/sessions/sess_0198c... \
  -H "Authorization: Bearer $ARIA_AGENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status": "archived", "metadata": {"resolution": "resolved"}}'

PIN API

ROUTER API

AGENT API

Update an Aria Agent Cloud Session

Endpoint

Authentication

Path parameters

Request body

Response

Example

​Endpoint

​Authentication

​Path parameters

​Request body

​Response

​Example

Endpoint

Authentication

Path parameters

Request body

Response

Example