For Developers

Create Category

POST https://ed.link/api/v2/graph/classes/:class_id/categories

Create a category Categories for a given Class.

Request Parameters

ParameterTypeDescription
class_idstringThe UUID of the desired Class.
category_idstringThe UUID of the desired Category.

Request Body

The request body should contain a Categories object.

The following fields are allowed: title, weight, drop_lowest, position, .

The following fields are required: title, .

Sample Request

axios.post('https://ed.link/api/v2/graph/classes/00000000-0000-0000-0000-000000000000/categories/00000000-0000-0000-0000-000000000000', {
    headers: {
        authorization: `Bearer ${integration_access_token}`
    },
    data: {
        title: 'Example Category',
        position: 2
    }
});

Sample Response

The response contains the created Categories object.

{
    "$request": "00000000-0000-0000-0000-000000000000",
    "$data": {
        "title": "Example Category",
        "position": 2,
        "updated_date": "2021-12-27T18:53:45.077Z",
        "properties": {},
        "identifiers": [
            {"type":"schoology_id", "value": 123}
        ],
        "id": "00000000-0000-0000-0000-000000000000"
    }
}

Supported Providers

  • aspen
  • blackbaud
  • brightspace
  • canvas
  • classgather
  • google
  • microsoft
  • oneroster
  • powerschool
  • schoology
  • skyward
  • qmlativ
  • infinitecampus
  • rapididentity
  • sapphire
  • genesis
  • renweb