> For the complete documentation index, see [llms.txt](https://developerdocs.instructure.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developerdocs.instructure.com/services/canvas/resources/proficiency_ratings.md).
# Proficiency Ratings
API for customizing proficiency ratings
#### A ProficiencyRating object looks like:
```js
{
// The description of the rating
"description": "Exceeds Mastery",
// A non-negative number of points for the rating
"points": 4,
// Indicates the rating where mastery is first achieved
"mastery": false,
// The hex color code of the rating
"color": "02672D"
}
```
#### A Proficiency object looks like:
```js
{
// An array of proficiency ratings. See the ProficiencyRating specification
// above.
"ratings": []
}
```
## [Create/update proficiency ratings](#method.outcome_proficiency_api.create)
[OutcomeProficiencyApiController#create](https://github.com/instructure/canvas-lms/blob/master/app/controllers/outcome_proficiency_api_controller.rb)
#### `POST /api/v1/accounts/:account_id/outcome_proficiency`
**Scope:** `url:POST|/api/v1/accounts/:account_id/outcome_proficiency`
#### `POST /api/v1/courses/:course_id/outcome_proficiency`
**Scope:** `url:POST|/api/v1/courses/:course_id/outcome_proficiency`
Create or update account-level proficiency ratings. These ratings will apply to all sub-accounts, unless they have their own account-level proficiency ratings defined.
#### Request Parameters:
| Parameter | Type | Description |
| ------------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------- |
| `ratings[][description]` | `string` | The description of the rating level. |
| `ratings[][points]` | `integer` | The non-negative number of points of the rating level. Points across ratings should be strictly decreasing in value. |
| `ratings[][mastery]` | `integer` | Indicates the rating level where mastery is first achieved. Only one rating in a proficiency should be marked for mastery. |
| `ratings[][color]` | `integer` | The color associated with the rating level. Should be a hex color code like '00FFFF'. |
#### Example Request:
```bash
curl 'https://