Skip to main content
POST
Same question, fresh data — known sources only

Authorizations

Authorization
string
header
required

fn_live_… or fn_test_… — Authorization: Bearer

Headers

fn-version
string

Dated API version; defaults to the account pin. Honesty note: with one version in existence the gateway echoes any value back as effective WITHOUT validating it — validation against the known-versions set is planned, so send only real dated versions from https://docs.fiveninelabs.com/changelog

Example:

"2026-08-26"

Idempotency-Key
string

24h replay window; a retry never bills twice

Maximum string length: 255

Path Parameters

id
string
required

Body

application/json
max_spend_usd
number
required
max_age_s
integer

sources/results younger than this serve from record at $0

sources
string[]

sessions only: restrict to these domains

Response

The refresh run (a new session turn; sources younger than max_age_s served from record at $0)

id
string
required
Example:

"sess_9m2kd"

object
string
required
Allowed value: "session"
status
string
required

running | judging | answered | abstained | error | stopped (open enum)

created_at
string<date-time>
required
query
string
turn
integer
spend_usd
number
reserved_usd
number
max_spend_usd
number
sources
integer
records
integer
receipts_signed
integer
unchecked
integer

merchants never dispatched — a fact about us, stated

key_id
string
ended_at
string<date-time>
metadata
object