For Developers

Assignment

An assignment is a piece of course work inside of the LMS. Typically assignments will have a due date and point value. Students may or may not submit work in response to a particular assignment.

Assignments have a variety of properties that can be used to achieve the learning experience that you're looking for within the LMS. These properties are available in all systems that support content integration, unless otherwise noted. Some source systems may not support all values (e.g., some systems may not allow file upload submissions to an assignment). Occasionally, we will also provide special properties unique to only one system, if the functionality achieved is important enough to create a special case.

Please note that due_date is a required field for our system but some LMS's do not require a due date for assignments. In these cases, we will return null for the due_date field when retrieving assignments from the LMS.

Properties

PropertyTypeDescription
idStringA string (not a UUID) that corresponds to this assignment. These IDs are the LMS ID and are not guaranteed to be unique (even within the same source system).
descriptionStringThe assignment description or instructions in full HTML.
description_plaintextStringThe assignment description or instructions in plaintext for systems that do not support HTML bodies.
display_dateDateThe timestamp when the assignment will be visible to students.
due_dateDateThe timestamp when the assignment will be due for students.
lock_dateDateThe timestamp when late submissions will no longer be accepted.
points_possibleNumberThe point value for the assignment.
grading_periodTerm IDThe grading period (term) ID that this item should be assigned into.
grading_typeStringThe grading scale. Typically points.
publishedBooleanWhether or not the assignment is published.
titleStringThe assignment title.
urlStringThe URL to the assignment within the LMS.
submission_typesString The allowed submission types. If not specified, providers may not accept submissions.
personalizedBooleanWhether or not this is assigned to all students.
studentsUUID An array of person_ids of the students to whom this item is assigned (if personalized is true).
courseOrganizationThe course to which this item is assigned.
sourceSourceThe data source for this assignment.