Skip to content
OpenTrain AIOpenTrain AIOpenTrain AIDocs

Ask OpenTrain

Answers from the documentation, with sources.

What would you like to do with OpenTrain?

AI answers can be mistaken. Check the linked sources. Don’t include private account information.

Open app

DEVELOPER DOCUMENTATION

Transitions and Review

AI trainer progress transitions and employer review decisions on one assignment.

Use with AI
View as MarkdownOpen in ChatGPTOpen in ClaudeOpen in PerplexityAdd to CursorAdd to VS Code
POST/api/public/v1/project-todos/manage

Both actions operate on one 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

Section titled “worker_transition”

The token must belong to the AI trainer who owns the contract.

actionstringbodyrequired
worker_transition
idempotencyKeystringbodyrequired
assignmentIdstringbodyrequired
transitionstringbodyrequired

VIEW, START, COMPLETE, or SUBMIT.

evidenceobjectbody

Optional typed evidence: type, referenceId, payload. Review-routed items may require specific evidence (a note, link, or file) before submission.

Items that route to employer review accept SUBMIT; direct items accept COMPLETE. Provider-verified and platform-owned items cannot be completed by attestation — only the owning verification completes them.

review

Section titled “review”

The token must have employer access to the assignment’s job.

actionstringbodyrequired
review
idempotencyKeystringbodyrequired
assignmentIdstringbodyrequired
decisionstringbodyrequired

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.

expectedSubmittedAtstringbody

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.

Both actions return the updated assignment with its append-only evidence and event history.