Create a draft assessment

POST 
/api/v1/assessments/drafts

Create a partial (draft) assessment for later finalization.

Drafts are partial assessments that can be saved, uploaded to, and validated before any credits are spent. The draft is issued a random code with a -DRAFT suffix (e.g. XKR-DRAFT) that works in URLs until the final code is minted on start.

• Scope required: assessments:create + manager-or-above role.
• Rate-limit tier: assessment_draft (30/hour/user).
• No credit side-effects until POST /drafts/{id}/start.

Request

Responses

200

Successful Response

400

Bad request — malformed input or failed validation.

401

Missing, expired, or invalid credentials.

403

Authenticated but not authorized for this resource. Note: cross-organization reads return 404, not 403.

404

Resource not found, or hidden for tenant-enumeration safety (the caller lacks permission to know whether the resource exists).

409

Conflict — the current resource state does not allow this operation (e.g. assessment already started, email already in use).

422

Semantic validation failure — request shape was valid but contents were not.

429

Too many requests — rate limited. Retry after the window resets.

500

Internal server error — unexpected failure.