Create custom task
Public API — Tasks
Create custom task
Adds a new custom task to your organisation library. Field requirements depend on task_type (coding, mcq, text).
Responses
| Status | When |
|---|---|
201 | Task created |
400 | Serializer validation failed |
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
Create custom task
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.
Body
Required string length:
1 - 500Available options:
mcq, coding, text Available options:
easy, medium, hard Required range:
0 <= x <= 2147483647Required range:
0 <= x <= 2147483647List of {id, text, is_correct} dicts for MCQ
MCQ: allow selecting multiple answers
Available options:
python, sql, javascript, Keywords/criteria for scoring
Response
Maximum string length:
500Available options:
mcq, coding, text Available options:
easy, medium, hard Required range:
0 <= x <= 2147483647Required range:
0 <= x <= 2147483647List of {id, text, is_correct} dicts for MCQ
MCQ: allow selecting multiple answers
Available options:
python, sql, javascript, Keywords/criteria for scoring
Last modified on August 27, 2026