Cancel draft validation
POST/api/v1/assessments/drafts/:draft_id/cancel
Cancel validation and revert the assessment back to draft.
Allowed while validating or ready. Uses an atomic CAS to
prevent races with the running validation task. Cleans up merged
archive keys and cached source_files_json.
- Scope required:
assessments:cancel+ manager-or-above role. - Rate-limit tier: read/default.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 409
- 422
- 429
- 500
Successful Response
Bad request — malformed input or failed validation.
Missing, expired, or invalid credentials.
Authenticated but not authorized for this resource. Note: cross-organization reads return 404, not 403.
Resource not found, or hidden for tenant-enumeration safety (the caller lacks permission to know whether the resource exists).
Conflict — the current resource state does not allow this operation (e.g. assessment already started, email already in use).
Semantic validation failure — request shape was valid but contents were not.
Too many requests — rate limited. Retry after the window resets.
Internal server error — unexpected failure.