v34

latestOpenAPI 3.0.0raw.githubusercontent.com2026-07-215423105.7 KB

List Run Messages

Returns a paginated list of messages produced by a run, in chronological order, with the oldest messages first.

Messages conform to the AI SDK UIMessage format.

get/v1/agents/runs/{runId}/messages

Path parameters

runIdstring uuid required

The run ID.

Query parameters

sincestring

The id of the last message you've already received. The response will contain messages produced after that one, in chronological order. Omit on the first call. Pass the previous response's nextSince value to continue paging or to poll for new messages.

limitinteger

Maximum number of messages to return.

allboolean

Return every message after since in one response, ignoring limit.

Response

The page of messages, in chronological order, with the oldest messages first.

nextSincestring nullable required

The id of the last message in data. Pass it back as since on the next request to continue paging, or to poll for new messages. null only when the run has no messages yet; in that case, omit since and retry.