Update Grade

Updates the grade for a specific assessment attempt by ID

Updates the grade for a specific assessment attempt by ID.

PUThttps://example.thoughtindustries.com/incoming/v2/assessmentAttempts/:id/updateGrade

Example request

curl -X PUT "https://example.thoughtindustries.com/incoming/v2/assessmentAttempts/:id/updateGrade" \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "grade": 0
}'

Parameters

Name	Type	Required	Location	Description
`id`	`uuid`	Yes	path	The unique identifier of the assessment attempt to update.
`grade`	`integer`	Yes	body	The new grade to assign to the assessment attempt, expressed as a whole number percentage (e.g., `85` for 85%).

Example response

{
  "id": "00000000-0000-0000-0000-000000000000",
  "user": {
    "id": "00000000-0000-0000-0000-000000000000",
    "firstName": "string",
    "lastName": "string",
    "email": "string",
    "externalCustomerId": "00000000-0000-0000-0000-000000000000"
  },
  "course": {
    "id": "00000000-0000-0000-0000-000000000000",
    "title": "string"
  },
  "assessment": {
    "id": "00000000-0000-0000-0000-000000000000",
    "type": "string",
    "title": "string"
  },
  "originalGrade": 0,
  "grade": 0,
  "passed": true
}

Response fields

Field	Type	Description
`id`	`uuid`	Unique identifier of the assessment attempt.
`user`	`User`	User who made the attempt.
`user.id`	`uuid`	Unique identifier of the user.
`user.firstName`	`string`	First name of the user.
`user.lastName`	`string`	Last name of the user.
`user.email`	`string`	Email address of the user.
`user.externalCustomerId`	`uuid`	External customer identifier associated with the user.
`course`	`Course`	Course the assessment attempt belongs to.
`course.id`	`uuid`	Unique identifier of the course.
`course.title`	`string`	Title of the course.
`assessment`	`Assessment`	Assessment the attempt belongs to.
`assessment.id`	`uuid`	Unique identifier of the assessment.
`assessment.type`	`string`	Type of the assessment.
`assessment.title`	`string`	Title of the assessment.
`originalGrade`	`integer`	The attempt's grade before this update.
`grade`	`integer`	The updated grade recorded for the attempt.
`passed`	`boolean`	Indicates whether the attempt passed at the new grade.