Skip to main content
POST
Close a Preview

Authorizations

X-API-Key
string
header
required

Path Parameters

session_id
string<uuid>
required

Query Parameters

dry_run
boolean
default:false

Report what would happen, and change nothing.

Response

Successful Response

A whole Preview, as the reviewer's page polls it.

Everything the page needs in one payload: the phase (status), and the examples with their answers and verdicts. The page keeps polling while any example runs, a Needs work redo included.

created_at
string<date-time>
required
cycle
integer
required
error
string | null
required
id
string<uuid>
required
progress
TrainingProgressSchema · object
required

How far the examples' run has got.

rows
TrainingRowReadSchema · object[]
required
saved_agent_id
string<uuid>
required
source_input_mappings
Source Input Mappings · object
required
source_kind
enum<string>
required

Where a session's training inputs came from.

Available options:
table,
manual
source_table_id
string<uuid> | null
required
status
enum<string>
required

Where an agent Preview stands: the state the reviewer's screen shows.

One enum rather than a separate lifecycle flag and phase, because the phase IS the state: a session is either waiting on the machine (RUNNING), waiting on the reviewer (REVIEWING), or finished. Callers never derive the screen from row counts. A Needs work on one example runs that example again without leaving REVIEWING: the row's own status says it is running.

Available options:
running,
reviewing,
proposed,
completed,
abandoned
updated_at
string<date-time>
required