Skip to main content
POST
Propose a revised prompt

Authorizations

Authorization
string
header
required

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

Path Parameters

session_id
string<uuid>
required

Body

application/json

A request for a revised prompt, optionally critiquing a prior proposal.

revision_request
string
default:""

What to change about the proposal already on screen.

Maximum string length: 2000

Response

Successful Response

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

Everything the page needs in one payload: the phase (status), the cycle, the rows with their results and critiques, and the pending proposal when there is one.

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

How far the current cycle's run has got.

proposal
TrainingProposalSchema · object | null
required

A pending prompt revision, alongside what it would replace.

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 a training session 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, PROPOSED), or finished. Callers never derive the screen from row counts.

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