Grading Categories

Fields

FieldDescriptionType
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

None

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

None

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

None

Return

None