> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ariacompute.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update an Aria Agent Cloud Session

> Update an Aria Agent Cloud session's status or metadata in place. Uses the OpenAI beta partial-update convention with POST.

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

```http theme={null}
POST /v1/agents/sessions/{session_id}
```

## Authentication

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

## Path parameters

<ParamField path="session_id" type="string" required>
  Session identifier.
</ParamField>

## Request body

<ParamField body="status" type="string">
  New session status, such as `active` or `archived`.
</ParamField>

<ParamField body="metadata" type="object">
  Replacement metadata object.
</ParamField>

## Response

Returns the full updated session (same shape as [Get Session](/api-reference/agent/sessions/get)).

## Example

```bash theme={null}
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"}}'
```


## Related topics

- [Delete an Aria Agent Cloud Session by ID](/api-reference/agent/sessions/delete.md)
- [Update an Aria Agent Cloud Agent Definition](/api-reference/agent/agents/update.md)
- [List Aria Agent Cloud Sessions](/api-reference/agent/sessions/list.md)
- [Create Aria Agent Cloud Session for an Agent](/api-reference/agent/sessions/create.md)
- [Retrieve an Aria Agent Cloud Session by ID](/api-reference/agent/sessions/get.md)