# Proficiency Ratings
{% hint style="warning" %}
**Welcome to Our New API Docs!** This is the new home for all things API (previously at [Canvas LMS REST API Documentation](https://api.instructure.com)).
{% endhint %}
## Proficiency Ratings API
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://