agent-training

Save a row's verdict

Record this cycle's good-or-bad verdict on one row's output. A bad verdict must carry a note saying what to change; a good one carries none. A null verdict withdraws whatever was recorded.

put/agent-training/sessions/{session_id}/rows/{row_id}/feedback/

Request

  • Base URL: https://api.getoneprofile.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.getoneprofile.ai/agent-training/sessions/{session_id}/rows/{row_id}/feedback/
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

session_idstring uuid required
row_idstring uuid required

Request body

feedbackstring

What was wrong and how to change it. Required when the verdict is bad.

verdict'good' | 'bad'

The reviewer's call on one row's output.

Kept as its own enum rather than reusing the cells' up/down thumbs: a training verdict is a judgement on a worked example, and the two domains are deliberately independent of each other.

BAD always carries a note, because a complaint with no explanation gives the prompt rewrite nothing to act on. GOOD never does: it says the output was right, and the rewrite is told to preserve whatever produced it.

Response

Successful Response

created_atstring date-time required
cycleinteger required
errorstring nullable required
idstring uuid required
saved_agent_idstring uuid required
source_input_mappingsobject required
source_kind'table' | 'manual' required

Where a session's training inputs came from.

source_table_idstring uuid nullable required
status'running' | 'reviewing' | 'proposed' | 'completed' | 'abandoned' 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.

updated_atstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.