Skip to main content
GET
Retrieve a session’s messages, oldest first. Assistant messages carry citation parts that deep-link to a recording_id + start_ms.

Authentication

Requires an API key. The session is looked up within the key’s project; an unknown session returns 404. An end-user-scoped key can only read its own sessions.

Path Parameters

id
string
required
Session identifier (as_*).

Query Parameters

limit
integer
default:"20"
Maximum number of messages to return (1–100).
cursor
string
Pagination cursor from a previous response’s next_cursor.

Response

Returns a paginated list of messages, oldest first.

Message Fields

FieldTypeDescription
rolestringuser or assistant
contentstringPlain-text message content
partsarrayRich content: text segments and (assistant only) citation parts ({ type, recording_id, start_ms })
tokensobjectToken usage { input, output, cached }; null for user messages
model / providerstring | nullThe model and provider that produced an assistant message
finish_reasonstring | nullWhy generation stopped (assistant only)
created_atstringTimestamp