/v1/assignments
Headers
- Type: stringidempotency
-key min length:1max length:255Any unique string of 1 to 255 printable characters, such as a UUID. A create without it is refused with 400. The same key and request within 30 days answers with the first response and creates nothing.
Body
required
application/json
- Type: stringclass
Id min length:1max length:64required - Type: stringtask
Id min length:1max length:64required - Type: stringtitlemin length:1max length:200required
- Type: stringexternal
Ref min length:1max length:128
Responses
- application/json
- application/json
- application/json
- application/json
- application/json
- application/json
- application/json
- application/json
- application/json
- application/json
Request Example for post/v1/assignments
curl /v1/assignments \
--request POST \
--header 'idempotency-key: 0b8a3f5e-1c2d-4e6f-8a9b-7c6d5e4f3a2b' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"classId": "cls_0196f2a0-4c1e-7a00-8000-000000000001",
"externalRef": "seed-partner-letter-home-7a",
"taskId": "tsk_0196f2a0-4c1e-7a00-8000-000000000001",
"title": "A letter home"
}'
{
"classId": "cls_0196f2a0-4c1e-7a00-8000-000000000001",
"createdAt": "2026-03-02T09:30:00.000Z",
"externalRef": "seed-partner-letter-home-7a",
"id": "asg_0196f2a0-4c1e-7a00-8000-000000000001",
"object": "assignment",
"rubricVersionId": "rbv_0196f2a0-4c1e-7a00-8000-000000000001",
"source": {
"displayName": "Seed Partner",
"kind": "partner",
"logoUrl": null,
"organisationId": "org_0196f2a0-4c1e-7a00-8000-000000000002"
},
"status": "open",
"taskId": "tsk_0196f2a0-4c1e-7a00-8000-000000000001",
"title": "A letter home",
"updatedAt": "2026-03-02T09:30:00.000Z"
}