Omni AI

Get Message

Changed on Nov 4, 2026

Read a finalized message using its parent thread for ownership and linked-account authorization. In-progress assistant messages are not available here; use the response polling endpoint instead.

get/v1/omni-ai/messages/{message_id}

Request

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

Path parameters

message_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.

Response

Finalized message with content parts

Example response

{
  "error": {
    "code": 400,
    "message": "Order quantity must be greater than zero"
  },
  "metadata": {
    "page_number": 1,
    "total_items": 42,
    "total_pages": 5
  },
  "data": {
    "content": {
      "parts": [
        {
          "action": {
            "prefill_order": {
              "action_type": "NEW",
              "orders": [
                {
                  "limit_price": "150.00",
                  "order_type": "LIMIT",
                  "quantity": "100",
                  "side": "BUY",
                  "symbol": "AAPL",
                  "time_in_force": "DAY"
                }
              ]
            }
          }
        }
      ]
    },
    "context": {
      "items": [
        {
          "data": {
            "change_pct": "-2.4",
            "range": "1d",
            "ticker": "NVDA"
          },
          "kind": "chart",
          "label": "NVDA intraday performance"
        }
      ]
    }
  }
}

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
- 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
- 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 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
- 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)