Sign in

v57

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

Create Thread

Create a new conversation thread.

Atomically creates a new thread and submits the first user turn. The response contains a response_id that should be polled via GET /omni-ai/responses/{response_id} for assistant output.

Two creation modes are supported:

  • instant — provide text with a natural-language prompt.
  • deep_insights — provide a target ticker and optional thesis for long-form research.
post/v1/omni-ai/threads

Request body

account_idinteger required
capabilitiesCapability[]
textstring nullable
thesisstring nullable
type'instant' | 'deep_insights' required

Thread creation mode.

Example request

{
  "account_id": 19816,
  "text": "What changed in NVDA today?",
  "type": "instant"
}

Response

Thread created. Poll the returned response_id for assistant output.

Example response

{
  "error": {
    "code": 400,
    "message": "Order quantity must be greater than zero"
  }
}