For Developers

Classes Overview

A Class is an instance of a Course. Many People can be Enrolled in a Class.

In previous versions of the Edlink API, this concept was called a Course.

In v2.0, we've corrected some of our terminology to be more accurate and universal. Please review Migration from v1.0 for more information.

Properties

PropertyTypeDescription
idstringThe UUID for the object.
$filter operators: equals in not in
created_dateDateWhen the object was first seen by Edlink.
updated_dateDateWhen the object was last changed in Edlink.
$filter operators: equals gt lt gte lte
namestringThe name of the object.
$filter operators: equals starts with contains in not in is known is unknown
descriptionstringThe description of the object.
picture_urlstringThe URL for the class' profile picture.
subjectsSubject[]DEPRECATED: The subjects this class is associated with. These are provided as plaintext and are not necessarily associated with the new subject_id property below.
grade_levelsGradeLevel[]The grade levels this class is associated with.
periodsstring[]DEPRECATED: The periods this class is taught. These are provided as plaintext and are not necessarily associated with the new period_ids property below.
stateClass StateThe state of the class.
$filter operators: equals in not in
localestringThe locale of the object.
time_zoneTimezoneThe tz database name of the object.
propertiesobjectNon-standard properties that may be of interest to the developer.
identifiersIdentifier[]Additional IDs associated with the object.
session_idsstring[]The UUIDs of the associated Sessions. $filter operators: equals in not in
course_idstringThe UUID of the associated Course. $filter operators: equals in not in
school_idstringThe UUID of the associated School.
department_idstringThe UUID of the associated Department. $filter operators: equals in not in
subject_idstringThe UUID of the associated Subject. $filter operators: equals in not in
period_idsstring[]The UUIDs of the associated Periods. $filter operators: equals in not in
room_idsstring[]The UUIDs of the associated Rooms. $filter operators: equals in not in

Notes

  • The subjects and periods properties have been deprecated in favor of the new Subject and Period models.
    • The old properties will still be supported through the lifespan of API V2, but they may not be as accurate as the new models.
  • The new subject_id property is singular.
  • When you use the $expand operator on periods, the result will clobber the deprecated periods property.

JSON Example

{
    "id": "00000000-0000-0000-0000-000000000000",
    "created_date": "2021-07-13T17:45:27.685Z",
    "updated_date": "2021-07-13T17:45:27.685Z",
    "name": "Defense Against the Dark Arts",
    "description": null,
    "picture_url": null,
    "grade_levels": ["06"],
    "subjects": ["CEDS.08"],
    "periods": ["1"],
    "state": "active",
    "locale": null,
    "time_zone": null,
    "properties": {},
    "session_ids": ["00000000-0000-0000-0000-000000000000"],
    "course_id": "00000000-0000-0000-0000-000000000000",
    "school_id": "00000000-0000-0000-0000-000000000000",
    "department_id": "00000000-0000-0000-0000-000000000000",
    "subject_id": "00000000-0000-0000-0000-000000000000",
    "period_ids": ["00000000-0000-0000-0000-000000000000"],
    "room_ids": ["00000000-0000-0000-0000-000000000000"]
}

Supported Providers

ProviderSupport