> ## 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.

# Create Aria Agent Cloud Session for an Agent

> Create an Aria Agent Cloud session bound to an agent. Sessions accumulate turns, items, memory fragments, and subagent state.

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

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

## Authentication

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

## Request body

<ParamField body="agent_id" type="string" required>
  Identifier of the agent to bind this session to.
</ParamField>

<ParamField body="metadata" type="object">
  Free-form metadata stored with the session.
</ParamField>

## Response

<ResponseField name="id" type="string">
  Session identifier.
</ResponseField>

<ResponseField name="object" type="string">
  Always `agent.session`.
</ResponseField>

<ResponseField name="agent_id" type="string">
  Bound agent identifier.
</ResponseField>

<ResponseField name="status" type="string">
  Session status, typically `active`.
</ResponseField>

<ResponseField name="metadata" type="object">
  Metadata provided at creation.
</ResponseField>

<ResponseField name="created_at" type="integer">
  Unix seconds.
</ResponseField>

## Example

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

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


## Related topics

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