/v1/assignments

​

Headers

  • Any 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

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"
}