Skip to main content
POST
Ask Stream

Authorizations

Authorization
string
header
required

Pass your pk_live_... API key as a Bearer token.

Body

application/json
query
string
required
Required string length: 1 - 2000
Example:

"What are our top blockers for Q1?"

timezone
string | null

IANA timezone identifier (e.g. "America/New_York") for resolving relative time references like "today" or "last week". Defaults to UTC.

Example:

"America/New_York"

metadata
Metadata · object | null

Restrict the evidence the model can ground its answer in to rows whose metadata contains ALL the given key/value pairs (AND-of-exact-match). Max 20 keys; string values only.

Example:

Response

Server-Sent Events stream. Each SSE message is one JSON AskStreamEvent; the stream closes after the final answer or error event. Experimental — ignore unknown event types.

type
string
required
Allowed value: "status"
message
string
required