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

# /candidates/:id/ratings

`PUT /candidates/{id}/ratings`

Updates or creates  an evaluation  for a candidate. Required scope: `w_candidates`. Accessible with all token types. If an evaluation already exists for the given member on the given stage, it is updated. Otherwise, a new one is created. The stage defaults to the candidate's current stage when stage_id is not provided.

## Path parameters

- `id` string, required

## Request body

- object
  - `member_id` string, required — The member adding the rating
  - `stage_id` string — The stage of the rating. If not provided this fallbacks to current stage of candidate
  - `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 `200`

OK

- object
  - `name` string, required

## Other responses

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

---

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