Skip to main content
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

Authentication

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

Path parameters

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

Response

string
Always agent.session.title.
string
Session the title belongs to (a child keeps its full namespaced id).
string
Current title text.
string
first_prompt (deterministic fallback) or provider (async override).
integer
Epoch milliseconds of the last write.
Also available from the SDKs: session.get_title() (Python) or await session.getTitle() (TypeScript).