Skip to main content
PUT
Replace custom task

Authorizations

Authorization
string
header
required

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

id
string<uuid>
required

Body

title
string
required
Required string length: 1 - 500
description
string
task_type
enum<string>
Available options:
mcq,
coding,
text
difficulty
enum<string>
Available options:
easy,
medium,
hard
points
integer
Required range: 0 <= x <= 2147483647
time_limit_minutes
integer | null
Required range: 0 <= x <= 2147483647
question
string
options
any

List of {id, text, is_correct} dicts for MCQ

allow_multiple
boolean

MCQ: allow selecting multiple answers

language
enum<string>
Available options:
python,
sql,
javascript,
starter_code
string
expected_output
string
rubric
string

Keywords/criteria for scoring

tags
any

Response

id
string<uuid>
required
read-only
title
string
required
Maximum string length: 500
created_at
string<date-time>
required
read-only
description
string
task_type
enum<string>
Available options:
mcq,
coding,
text
difficulty
enum<string>
Available options:
easy,
medium,
hard
points
integer
Required range: 0 <= x <= 2147483647
time_limit_minutes
integer | null
Required range: 0 <= x <= 2147483647
question
string
options
any

List of {id, text, is_correct} dicts for MCQ

allow_multiple
boolean

MCQ: allow selecting multiple answers

language
enum<string>
Available options:
python,
sql,
javascript,
starter_code
string
expected_output
string
rubric
string

Keywords/criteria for scoring

tags
any
Last modified on August 27, 2026