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
Session identifier, optionally a child id of the form <parent>::sub::<id>.
Response
Always agent.session.title.
Session the title belongs to (a child keeps its full namespaced id).
first_prompt (deterministic fallback) or provider (async override).
Epoch milliseconds of the last write.
Also available from the SDKs: session.get_title() (Python) or await session.getTitle() (TypeScript).