v57

latestOpenAPI 3.1.0Proprietaryraw.githubusercontent.com2026-07-2161198428.4 KB
Omni AI

Get Messages

List finalized messages in a thread.

Returns the latest page of finalized messages by default, with messages within each page ordered chronologically. Messages from in-progress assistant turns are excluded — use GET /omni-ai/threads/{thread_id}/response or GET /omni-ai/responses/{response_id} for live output.

If the last finalized message has role USER, an active response likely exists and should be polled separately.

get/v1/omni-ai/threads/{thread_id}/messages

Path parameters

thread_idstring uuid required

Thread to list messages for

Query parameters

account_idinteger required

Account ID for the request

page_sizeinteger

The number of items to return per page. Only used when page_token is not provided.

page_tokenstring byte

Base64URL-encoded pagination token

Token for retrieving the next or previous page of results. Contains encoded pagination state; when provided, page_size is ignored.

Response

Paginated list of finalized messages; latest page by default, chronological within each page