Grading categories are required for grading. Assignments without categories will be ungraded.
Table of Contents
Fields
Field | Name | Description | Type | Required |
id | | The ID of the grading category | integer | |
title | | The title of the grading category | string | |
calculation_type | | 1 corresponds to ‘Percent’. 2 corresponds to ‘Total pts’ | integer | |
default_max_points | | The default # of points to give to assignments when created | float | |
default_grading_scale_id | | 0 for numeric grading scale, or the id of the grading scale | integer | |
drop_lowest | | Number of low scores to drop in the category | integer {0-10} | |
weight | | Category weight | integer | |
delta | | List order of the category | integer | |
Operations
Bulk Create
Create one or more grading categories in a section
Path | POST https://api.schoology.com/v1/sections/{section_id}/grading_categories |
Content | An object containing grading category fields JSON {
"grading_categories": {
"grading_category": [
{
"title": "Experiments",
"weight": 100
},
{
"title": "In-class Work",
"calculation_type": 2,
"drop_lowest": 2
}
]
}
} XML <body>
<grading_categories>
<grading_category>
<title>Experiments</title>
<weight>100</weight>
</grading_category>
<grading_category>
<calculation_type>2</calculation_type>
<drop_lowest>2</drop_lowest>
<title>In-class Work</title>
</grading_category>
</grading_categories>
</body>
|
Return | JSON {
"grading_category": [
{
"id": "5823",
"response_code": 200,
"title": "Experiments",
"calculation_type": 2,
"default_max_points": 100,
"drop_lowest": 0,
"default_grading_scale": 0,
"weight": 100,
"delta": 0
},
{
"id": "5825",
"response_code": 200,
"title": "In-class Work",
"calculation_type": 2,
"drop_lowest": 2,
"default_max_points": 100,
"default_grading_scale": 0,
"weight": 100,
"delta": 0
}
]
} XML <result>
<grading_category>
<calculation_type>2</calculation_type>
<default_grading_scale>0</default_grading_scale>
<default_max_points>100</default_max_points>
<delta>0</delta>
<drop_lowest>0</drop_lowest>
<id>5823</id>
<response_code>200</response_code>
<title>Experiments</title>
<weight>100</weight>
</grading_category>
<grading_category>
<calculation_type>2</calculation_type>
<default_grading_scale>0</default_grading_scale>
<default_max_points>100</default_max_points>
<delta>0</delta>
<drop_lowest>2</drop_lowest>
<id>5825</id>
<response_code>200</response_code>
<title>In-class Work</title>
<weight>100</weight>
</grading_category>
</result>
|
List
List grading categories
Path | GET https://api.schoology.com/v1/sections/{section_id}/grading_categories |
Content | |
Return | An object containing grading category fields JSON {
"grading_category": [
{
"id": 4371,
"title": "DC",
"delta": 0,
"calculation_type": 1,
"default_max_points": 100,
"default_grading_scale_id": 0,
"drop_lowest": 6
},
{
"id": 4369,
"title": "AAA",
"delta": 1,
"calculation_type": 2,
"default_max_points": 100,
"default_grading_scale_id": 0,
"drop_lowest": 0
},
{
"id": 3266,
"title": "HMWK",
"delta": 2,
"calculation_type": 1,
"default_max_points": 100,
"default_grading_scale_id": 0,
"drop_lowest": 4
}
]
} XML <?xml version="1.0" encoding="utf-8" ?>
<result>
<grading_category>
<id>4371</id>
<title>DC</title>
<delta>0</delta>
<calculation_type>1</calculation_type>
<default_max_points>100</default_max_points>
<default_grading_scale_id>0</default_grading_scale_id>
<drop_lowest>6</drop_lowest>
</grading_category>
<grading_category>
<id>4369</id>
<title>AAA</title>
<delta>1</delta>
<calculation_type>2</calculation_type>
<default_max_points>100</default_max_points>
<default_grading_scale_id>0</default_grading_scale_id>
<drop_lowest>0</drop_lowest>
</grading_category>
<grading_category>
<id>3266</id>
<title>HMWK</title>
<delta>2</delta>
<calculation_type>1</calculation_type>
<default_max_points>100</default_max_points>
<default_grading_scale_id>0</default_grading_scale_id>
<drop_lowest>4</drop_lowest>
</grading_category>
</result>
|
View
View a specific grading category in a section
Path | GET https://api.schoology.com/v1/sections/{section_id}/grading_categories/{gc_id} |
Content | |
Return | An object containing grading category fields JSON {
"id": 5823,
"title": "Experimental Activities",
"delta": 0,
"realm": "course",
"realm_id": "373214",
"calculation_type": 2,
"default_max_points": 100,
"default_grading_scale_id": 0,
"drop_lowest": 3,
"weight": 100
} XML <?xml version="1.0" encoding="utf-8" ?>
<result>
<calculation_type>2</calculation_type>
<default_grading_scale_id>0</default_grading_scale_id>
<default_max_points>100</default_max_points>
<delta>0</delta>
<drop_lowest>3</drop_lowest>
<id>5823</id>
<realm>course</realm>
<realm_id>373214</realm_id>
<title>Experimental Activities</title>
<weight>100</weight>
</result>
|
Update
Update a single grading category in a section
Path | PUT https://api.schoology.com/v1/sections/{section_id}/grading_categories/{gc_id} |
Content | An object containing grading category fields JSON {
"title": "Experimental Activities New",
"id": 5823
} XML <?xml version="1.0" encoding="utf-8" ?>
<body>
<id>5823</id>
<title>Experimental Activities New</title>
</body>
|
Return | JSON {
"id": "5823",
"title": "Experimental Activities New",
"realm": "course",
"realm_id": "373214",
"uid": "45633",
"calculation_type": "2",
"weight": "100",
"default_max_points": "100",
"delta": "0",
"drop_lowest": "3",
"default_grading_scale": "0"
} XML <?xml version="1.0" encoding="utf-8" ?>
<result>
<calculation_type>2</calculation_type>
<default_grading_scale>0</default_grading_scale>
<default_max_points>100</default_max_points>
<delta>0</delta>
<drop_lowest>3</drop_lowest>
<id>5823</id>
<realm>course</realm>
<realm_id>373214</realm_id>
<title>Experimental Activities New</title>
<uid>45633</uid>
<weight>100</weight>
</result>
|
Bulk Update
Update one or more grading categories in a section
Path | PUT https://api.schoology.com/v1/sections/{section_id}/grading_categories |
Content | An object containing grading category fields JSON {
"grading_categories": {
"grading_category": [
{
"title": "Experiments",
"id": 5823,
"drop_lowest": 3
},
{
"title": "In-class Work",
"id": 5825,
"calculation_type": 1
}
]
}
} XML <?xml version="1.0" encoding="utf-8" ?>
<body>
<grading_categories>
<grading_category>
<drop_lowest>3</drop_lowest>
<id>5823</id>
<title>Experiments</title>
</grading_category>
<grading_category>
<calculation_type>1</calculation_type>
<id>5825</id>
<title>In-class Work</title>
</grading_category>
</grading_categories>
</body>
|
Return | JSON {
"grading_category": [
{
"response_code": 204,
"id": "5823",
"title": "Experiments",
"realm": "course",
"realm_id": "373214",
"uid": "45633",
"calculation_type": "2",
"weight": "100",
"default_max_points": "100",
"delta": "0",
"drop_lowest": 3,
"default_grading_scale": "0"
},
{
"response_code": 204,
"id": "5825",
"title": "In-class Work",
"realm": "course",
"realm_id": "373214",
"uid": "45633",
"calculation_type": 1,
"weight": "100",
"default_max_points": "100",
"delta": "0",
"drop_lowest": "2",
"default_grading_scale": "0"
}
]
} XML <?xml version="1.0" encoding="utf-8" ?>
<result>
<grading_category>
<calculation_type>2</calculation_type>
<default_grading_scale>0</default_grading_scale>
<default_max_points>100</default_max_points>
<delta>0</delta>
<drop_lowest>3</drop_lowest>
<id>5823</id>
<realm>course</realm>
<realm_id>373214</realm_id>
<response_code>204</response_code>
<title>Experiments</title>
<uid>45633</uid>
<weight>100</weight>
</grading_category>
<grading_category>
<calculation_type>1</calculation_type>
<default_grading_scale>0</default_grading_scale>
<default_max_points>100</default_max_points>
<delta>0</delta>
<drop_lowest>2</drop_lowest>
<id>5825</id>
<realm>course</realm>
<realm_id>373214</realm_id>
<response_code>204</response_code>
<title>In-class Work</title>
<uid>45633</uid>
<weight>100</weight>
</grading_category>
</result>
|
Delete
Delete a grading category (cannot be undone).
Path | DELETE https://api.schoology.com/v1/sections/{section_id}/grading_categories/{gc_id} |
Content | |
Return | |