---
title: "/candidates/:id/ratings"
method: POST
path: "/candidates/{id}/ratings"
---

# /candidates/:id/ratings

`POST /candidates/{id}/ratings`

Creates a rating for a candidate. Required scope: `w_candidates`. Accessible with all token types.

## Path parameters

- `id` string, required

## Request body

- object
  - `member_id` string, required — The member adding the rating
  - `comment` string, required — A comment about the scoring of the candidate
  - `scale` 'thumbs' | 'stars' | 'numbers' — The rating scale that corresponds to the grade. One of `thumbs` (graphic rating), `stars` (star rating) or `numbers` (numeric rating)
  - `grade` integer, required — The candidate grade. View details in the Grade paragraph above
  - `score` string — **DEPRECATED** One of `negative`, `positive` or `definite`. If the request payload includes score, the scale and grade fields are ignored
  - `score_card` object
    - `settings` object
      - `questions_rateable` boolean
    - `sections` object[], required
      - `id` number, required
      - `name` string, required
      - `score` string — One of `negative`, `positive` or `definite`
      - `traits` object[], required
        - `id` number, required
        - `name` string, required
        - `score` string — One of `negative`, `positive` or `definite`
        - `note` string
        - `questions` object[], required
          - `id` number, required
          - `body` string, required
          - `score` string — One of `negative`, `positive` or `definite`
          - `note` string

## Response `201`

201

## Other responses

- `401` — 401
- `404` — 404

---

[API](https://skmtc.net/workable/apis/root.md) · [All operations](https://skmtc.net/workable/apis/root/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/workable/root/versions/c4116349c08d/schema)