---
title: "Update Requirement Grade Assignments"
method: PUT
path: "/teacher/correction-preferences/requirements/{requirement_id}/grades"
tags: ["teacher_correction_preferences"]
---

# Update Requirement Grade Assignments

`PUT /teacher/correction-preferences/requirements/{requirement_id}/grades`

## Request

- Base URL: `https://api.excellence-ai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.excellence-ai.com/teacher/correction-preferences/requirements/{requirement_id}/grades`
- Auth: OAuth 2 (password, token URL `api/login`)

Update the grade assignments for a requirement.
Empty active_grades means the requirement applies to all grades.

## Path parameters

- `requirement_id` string, required

## Request body

- GradeAssignmentsUpdate
  - `active_grades` string[], required

## Response `200`

Successful Response

- CorrectionRequirementResponse
  - `id` string, required
  - `name` string, required
  - `prompt_text` string, required
  - `active_grades` string[]
  - `is_active` boolean, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `evicted_statements` string[]

## Other responses

- `404`: Resource not found
- `422`: Validation Error

## Changes

> 55 revisions in range; 1 not diffed.

- **2026-09-30** `518c1e6178a3`: 2 info
  - added the non-success response with the status `404`
  - added the optional property `evicted_statements` to the response with the `200` status

[Operation history](https://skmtc.dev/excellence-ai/apis/excellence-learning/changes/teacher/correction-preferences/requirements/:requirement_id/grades/put.md)

---

[API](https://skmtc.dev/excellence-ai/apis/excellence-learning.md) - [All operations](https://skmtc.dev/excellence-ai/apis/excellence-learning/llms.txt) - [OpenAPI document](https://skmtc.dev/excellence-ai/apis/excellence-learning/revisions/379e4a57dee8?raw)