Grading Standards API

A GradingSchemeEntry object looks like:

{
  
  //The name for an entry value within a GradingStandard that describes the range of
  //the value
  "name": "A",
  
  //The value for the name of the entry within a GradingStandard.  The entry
  //represents the lower bound of the range for the entry. This range includes the
  //value up to the next entry in the GradingStandard, or 100 if there is no upper
  //bound. The lowest value will have a lower bound range of 0.
  "value": 0.9
}

A GradingStandard object looks like:

{
  
  //the title of the grading standard
  "title": "Account Standard",
  
  //the id of the grading standard
  "id": 1,
  
  //the context this standard is associated with, either 'Account' or 'Course'
  "context_type": "Account",
  
  //the id for the context either the Account or Course id
  "context_id": 1,
  
  //A list of GradingSchemeEntry that make up the Grading Standard as an array of
  //values with the scheme name and value
  "grading_scheme": "[{"name":"A", "value":0.9}, {"name":"B", "value":0.8}, {"name":"C", "value":0.7}, {"name":"D", "value":0.6}]"
}

Create a new grading standard GradingStandardsApiController#create

POST /api/v1/accounts/:account_id/grading_standards

POST /api/v1/courses/:course_id/grading_standards

Create a new grading standard

If grading_scheme_entry arguments are omitted, then a default grading scheme will be set. The default scheme is as follows:

"A" : 94,
"A-" : 90,
"B+" : 87,
"B" : 84,
"B-" : 80,
"C+" : 77,
"C" : 74,
"C-" : 70,
"D+" : 67,
"D" : 64,
"D-" : 61,
"F" : 0,

Request Parameters:

  • title
    Required, String

    The title for the Grading Standard.

  • grading_scheme_entry[][name]
    Required, String

    The name for an entry value within a GradingStandard that describes the range of the value e.g. A-

  • grading_scheme_entry[][value]
    Required, Integer

    The value for the name of the entry within a GradingStandard. The entry represents the lower bound of the range for the entry. This range includes the value up to the next entry in the GradingStandard, or 100 if there is no upper bound. The lowest value will have a lower bound range of 0. e.g. 93

Example Request:

curl https://<canvas>/api/v1/courses/<course_id>/grading_standards \
  -X POST \
  -H 'Authorization: Bearer <token>' \
  -d 'title=New standard name' \
  -d 'grading_scheme_entry[][name]=A'
  -d 'grading_scheme_entry[][value]=90'
  -d 'grading_scheme_entry[][name]=B'
  -d 'grading_scheme_entry[][value]=80'

Example Response:

{
  "title": "New standard name",
  "id": 1,
  "context_id": 1,
  "context_type": "Course",
  "grading_scheme": [
    {"name": "A", "value": 0.9},
    {"name": "B", "value": 0.8}
  ]
}
Returns a GradingStandard

List the grading standards available in a context. GradingStandardsApiController#context_index

GET /api/v1/courses/:course_id/grading_standards

GET /api/v1/accounts/:account_id/grading_standards

Returns the list of grading standards in the given context that are visible to user.

Example Request:

curl https://<canvas>/api/v1/courses/1/grading_standards \
  -H 'Authorization: Bearer <token>'