Omni AI

Get Messages

Changed on Nov 4, 2026

List finalized messages, including messages created before the account link. Return the latest page by default, in chronological order within each page. Use the returned page token to navigate history.

In-progress assistant output is not included. Poll GET /omni-ai/threads/{thread_id}/response and refresh messages when a response ends to read its finalized message here. Some answers start without a request: a response with no user_message_id presents a background result, such as a subagent's report, so keep polling the thread response while the thread is open rather than only after sending a message.

Hide assistant messages with outcome merged. They have no content, and a later answer covers their turn.

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

Request

Base URL
https://api.clearstreet.com
Auth
HTTP bearer

Path parameters

thread_idstring uuid required

Query parameters

account_idinteger

Lists only conversations for this account, or unlinked conversations when omitted. Other reads authorize the resource's linked account. Omit when no account is selected; empty values and the string null are invalid.

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

Changes

Nov 4, 202652e77ea7d731 Revision changes
- warning
  added the new merged enum value to the /// response property for the response status
- warning
  added the new steered enum value to the /// response property for the response status
Oct 16, 20261bd9eddeffc8 Revision changes
- breaking
  the //////////////////// response's property type changed from object to no type for status
- breaking
  the //////////////////// response's property type changed from object to no type for status
- breaking
  removed the required property ///////////////////// from the response with the status
- breaking
  removed the required property ///////////////////// from the response with the status
- breaking
  removed the required property ///////////////////// from the response with the status
- breaking
  removed the required property ///////////////////// from the response with the status
- breaking
  removed the required property ///////////////////// from the response with the status
- breaking
  removed the required property ///////////////////// from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- warning
  for the query request parameter account_id, the min was set to 1.00
- warning
  removed the optional property ///////////////////// from the response with the status
- warning
  removed the optional property ///////////////////// from the response with the status
- warning
  removed the optional property ///////////////////// from the response with the status
- warning
  removed the optional property ///////////////////// from the response with the status
- warning
  removed the optional property ///////////////////// from the response with the status
- warning
  removed the optional property ///////////////////// from the response with the status
- warning
  removed the optional property ///////////////////// from the response with the status
- warning
  removed the optional property ///////////////////// from the response with the status
- warning
  removed the optional property ///////////////////// from the response with the status
- warning
  removed the optional property ///////////////////// from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- info
  the query request parameter account_id became optional
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property /////////// to the response with the status
- info
  added the optional property /////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property /// to the response with the status
- info
  added subschema #1 subschema #2 to the //////////////////// response property allOf list for the response status
- info
  added subschema #1 subschema #2 to the //////////////////// response property allOf list for the response status
- info
  added subschema #1 subschema #2 to the //////////////////// response property allOf list for the response status
- info
  removed subschema #1 subschema #2 from the //////////////////// response property allOf list for the response status
- info
  added the required property /////////// to the response with the status
- info
  added the required property //////////// to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status

Operation history (10 revisions)