Skip to main content
POST
Ask the AI Assistant, streaming its work

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

conversation_id
string<uuid>
required

Body

application/json

Send the AI Assistant a message.

record_type and query are the search on screen, when there is one: the results panel sends them so a refinement builds on what the user sees. The page sends neither. The query is checked against the same schema a hand-built search goes through, and unknown filters are stripped.

prompt
string
required
Required string length: 1 - 4000
query
Query · object | null
record_type
enum<string> | null

Which dataset a search runs against, and so which provider serves it.

Values are persisted in String(16) columns, so every member must stay within 16 characters.

Available options:
people,
companies,
signal_companies,
signal_people,
lookalikes,
local_businesses,
tech_companies,
hiring_companies
surface
enum<string>
default:panel

Where a turn was sent from, for the turn log only.

Available options:
page,
panel

Response

A stream of Server-Sent Events. The final result frame's data is a turn; an error frame's data is a stream error.

Both halves of one turn, as saved.

The user message too, not just the reply: the client drew its own copy before sending and reconciles it against this one.