Add assignment

Creates a new assignment: links one or more quizzes to a class, with instructions and an optional due date.

POST /++add_assignment

Classes & Enrollment

Authentication

Requires an authenticated (logged-in) account. Also requires a registered Integrator subscription.

This endpoint requires the calling application to be registered as an Integrator. Every call must identify the registration via a registration_id parameter (or an X-Client-Id header), and authenticate using one of the following methods, selected with the subscription_method parameter:

  • referer — The request's HTTP Referer header must match one of the domains authorized for this Integrator registration.
  • ip — The request's source IP address must match one of the IP addresses authorized for this Integrator registration.
  • client_token — A client token issued at registration time is supplied with the request.

Register as an Integrator and configure authorized domains, IP addresses, or a client token.

Request

Content type: application/json

NameInTypeRequiredDescription
BODYbodystringNo—
quiz_uidbodystringNo—
titlebodystringNo—
teacher_idbodystringNo—
class_idbodystringNo—
instructionsbodystringNo—
due_datebodystringNo—
statusbodystringNo—
talbodystringNoSent by the web client (found via frontend call-site tracing).
tabquerystringNoSent by the web client (found via frontend call-site tracing).

Example request body

{
  "BODY": "example_value",
  "quiz_uid": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
  "title": "Sample Title",
  "teacher_id": "12345",
  "class_id": "12345",
  "instructions": "example_value",
  "due_date": "2026-01-15",
  "status": "published"
}

Responses

StatusMeaning
200Successful response.
201Created successfully.
400Invalid JSON body.
500Unknown error
401Unauthorized - missing or invalid Integrator authentication (registration_id/X-Client-Id, plus referer/IP/client_token).
403Forbidden - the current user or Integrator registration does not have sufficient permissions.