Attach assessment tasks
Public API — Assessments
Attach assessment tasks
Appends one or more tasks to an assessment. Pass { tasks: [...] } or a single { task_id, source } object. source is platform (default) or org. Duplicates are skipped. Blocked after candidates have started.
Required scope:
assessments:write
Responses
| Status | Code | When |
|---|---|---|
201 | — | Tasks attached (may be empty if all were duplicates) |
403 | LIMIT_REACHED | Plan task-per-assessment limit |
404 | TASK_NOT_FOUND | Platform or org task id invalid |
409 | TASKS_LOCKED | Candidates have already started |
Authentication & rate limits (all endpoints)
| Status | Code | When |
|---|---|---|
401 | INVALID_API_KEY | Missing or invalid bearer token |
401 | EXPIRED_API_KEY | API key past its optional expires_at |
403 | INSUFFICIENT_SCOPE | API key lacks the required scope for this operation |
403 | IP_NOT_ALLOWED | Client IP is outside this key’s CIDR allowlist |
429 | RATE_LIMITED | Rate limit exceeded — plan-tiered reads/writes per organisation per hour |
POST
Attach assessment tasks
Authorizations
Organisation API key created in Assess → Developer → API Keys. Format: Bearer ct_live_<your-key> (live) or Bearer ct_test_<your-key> (test). Optional per-key CIDR allowlists return 403 IP_NOT_ALLOWED.
Path Parameters
Body
Last modified on August 27, 2026