Transitions and Review
Project To-dos
Transitions and Review
AI trainer progress transitions and employer review decisions on one assignment.
POST
Transitions and Review
Both actions operate on one
The token must belong to the AI trainer who owns the contract.
Items that route to employer review accept
The token must have employer access to the assignment’s job.
Both actions return the updated assignment with its append-only evidence and event history.
assignmentId and require project_todos:write. Transitions and evidence dedupe on the idempotencyKey, so retries converge; a key replayed against a different assignment returns 409.
worker_transition
The token must belong to the AI trainer who owns the contract.
string
required
worker_transitionstring
required
string
required
string
required
VIEW, START, COMPLETE, or SUBMIT.object
Optional typed evidence:
type, referenceId, payload. Review-routed items may require specific evidence (a note, link, or file) before submission.SUBMIT; direct items accept COMPLETE. Provider-verified and platform-owned items cannot be completed by attestation — only the owning verification completes them.
review
The token must have employer access to the assignment’s job.
string
required
reviewstring
required
string
required
string
required
APPROVE completes. RETURN sends it back with feedback. WAIVE drops the requirement for that person. CLOSE revokes the obligation. A reason is required for RETURN, WAIVE, and CLOSE.string
Stale-review guard: the exact
submittedAt you reviewed. If the AI trainer resubmitted in the meantime, the decision is rejected instead of acting on evidence you never saw.