Sign in
public-api

Public Submit Review

Submit a review verdict on a trace (TRA-1052) — the write half of the queue above, so Claude agents review through the same flow humans do.

Same upsert as the app's review composer: reviewing a dreamer/eval flag settles that row (its flag source is preserved, exactly as a human review would), and a trace nobody flagged gets a fresh source='agent' row. The one divergence: a row a HUMAN created is 409 — the API must not silently replace a person's verdict while the row still displays as theirs.

post/v1/review

Headers

authorizationstring nullable

Request body

trace_idstring required
trace_keystring required
approvedboolean required
notesstring
review_status'reviewed' | 'dismissed'

Response

Successful Response

label_idstring uuid required
trace_idstring required
review_status'unreviewed' | 'reviewed' | 'dismissed' | 'held' required
approvedboolean required
notesstring required
source'human' | 'dreamer' | 'eval' | 'agent' required
created_atstring required
updated_atstring required

Changes

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