Omni AI

Get Thread

Changed on Oct 16, 2026

Read an owned thread's metadata. Use GET /omni-ai/threads/{thread_id}/messages for conversation history.

Omission or another account selection does not change authorization.

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

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.

Response

Thread metadata

Example response

{
  "error": {
    "code": 400,
    "message": "Order quantity must be greater than zero"
  },
  "metadata": {
    "page_number": 1,
    "total_items": 42,
    "total_pages": 5
  }
}

Changes

Oct 16, 20261bd9eddeffc8 Revision changes
- 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
- 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 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