Retakes and Remediation Plans
Quizzes
Retakes and Remediation Plans
Grant a corrected attempt with a stale-review guard, and validate retake batches without writing.
POST
Retakes and Remediation Plans
A retake is a returned submission: the AI trainer sees your reason, the to-do reopens, and they get exactly one extra attempt on the same published version. Requires
The retake allowance is additive: each return grants one more attempt beyond the version’s published limit. Grading and release remain separate operations.
Validates a whole remediation batch without writing, so an agent can build a review-then-execute workflow.
The plan checks every row against live state — binding identity, current submission, and grade/release feasibility — and returns ordered per-row commands with stable content-derived keys, plus a deterministic plan checksum.
project_todos:write.
require_retake
string
required
require_retakestring
required
string
required
The quiz to-do assignment to return.
string
required
Worker-visible feedback about what to correct.
string
required
The exact
submittedAt you reviewed. If the AI trainer resubmitted in between, the return is rejected with 409 instead of acting on evidence you never saw.string
Optional binding proof: the exact attempt you reviewed. A mismatch rejects the return.
require_retake_plan
Validates a whole remediation batch without writing, so an agent can build a review-then-execute workflow.
string
required
require_retake_planstring
required
array
required
1–500 rows of
{ "rowKey", "assignmentId", "reason", "expectedSubmittedAt", "attemptId?", "grade?", "release?" }.Limitation
A one-call atomic batch apply is not currently available: execute the plan’s emitted commands individually (grade, release, require_retake), each with its provided idempotency key so retries stay convergent. The plan itself never writes.