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

# Get a Session Title

> Read the projected session title: the deterministic first prompt is written once, an async provider may override it, and child sessions are readable via their parent.

Read a session title. The title is a **projection** of `SessionEvent::TitleSet` in the event stream, not a second source of truth: the deterministic first-prompt title (`source: first_prompt`) is written once, and an optional async title provider may replace it (`source: provider`). A session has no title until its first turn, which returns `404`.

A delegated child session id looks like `<parent>::sub::<id>` and is not a first-class session row; the server walks up the `::sub::` chain to authorise through the parent, so the parent's owner can read the child's title too.

## Endpoint

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

## Authentication

`Authorization: Bearer <api_key>` or `Authorization: ApiKey <key>`. Optional if `AGENT_CLOUD_API_KEY` is unset.

## Path parameters

**session\_id** `string` *required*

Session identifier, optionally a child id of the form `<parent>::sub::<id>`.

## Response

**object** `string`

Always `agent.session.title`.

**session\_id** `string`

Session the title belongs to (a child keeps its full namespaced id).

**title** `string`

Current title text.

**source** `string`

`first_prompt` (deterministic fallback) or `provider` (async override).

**updated\_at** `integer`

Epoch milliseconds of the last write.

```bash cURL theme={null}
curl https://agent.ariacompute.com/v1/agents/sessions/sess_9f8e7d6c5b4a3210fedc/title \
  -H "Authorization: Bearer $ARIA_AGENT_KEY"
```

```json 200 theme={null}
{
  "object": "agent.session.title",
  "session_id": "sess_9f8e7d6c5b4a3210fedc",
  "title": "When did the Roman Empire fall?",
  "source": "first_prompt",
  "updated_at": 1740000000000
}
```

Also available from the SDKs: `session.get_title()` (Python) or `await session.getTitle()` (TypeScript).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.