Skip to main content
POST
Create a rubric
Step 1 of 3 in Create a rubric.

Rules

  • name is required. description is optional.
  • Keep the trailing slash on the path. Without it the API redirects, and most HTTP clients drop the request body when they follow a redirect.
  • A new rubric has no criteria. rubricCriteria stays [] until you add one.
  • Save the id from the response. You need it to add criteria and to attach the rubric to an assignment.
When the token is missing, invalid, or expired, this API answers 403, not 401. See API errors.

Next step

Add a rubric criterion

Add the first thing the rubric measures, with a band for every score it can award.

Authorizations

Authorization
string
header
required

Access token from Get an access token.

Body

application/json
name
string
required

Name of the rubric.

Example:

"Grade 5 English homework"

description
string

Optional longer explanation of the rubric.

Example:

"Grades handwritten English homework on grammar and clarity."

Response

The rubric was created. rubricCriteria is empty until you add a criterion.

A rubric and all of its criteria.

id
string<uuid>

Unique ID of the rubric. Send it as rubricId when you attach the rubric to an assignment.

Example:

"2b973c83-2830-4712-87b7-64a8c0a99035"

name
string

Name of the rubric.

Example:

"Grade 5 English homework"

description
string | null

Longer explanation of the rubric. null if you did not send one.

Example:

"Grades handwritten English homework on grammar and clarity."

rubricCriteria
object[]

Every criterion on this rubric, oldest first. Empty until you add one.

createdAt
string<date-time>
Example:

"2026-03-27T11:30:18.402117Z"

modifiedAt
string<date-time>
Example:

"2026-03-27T11:30:18.402145Z"