---
title: "Set (or clear) the star rating (1-5) of a candidate."
method: POST
path: "/api/external/candidate/rating/update"
tags: ["Candidate APIs"]
---

# Set (or clear) the star rating (1-5) of a candidate.

`POST /api/external/candidate/rating/update`

## Headers

- `RF-Api-Key` string
- `content-type` string

## Request body

- object
  - `id` integer — Candidate ID
  - `rating` integer — Rating from 1 to 5. Pass null (or 0) to clear the rating.
  - `user_id` integer — User ID setting the rating.

## Response `200`

Auto generated using Swagger Inspector

---

[API](https://skmtc.dev/recruiterflow/apis/recruiterflow-api-documentation.md) · [All operations](https://skmtc.dev/recruiterflow/apis/recruiterflow-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/recruiterflow/recruiterflow-api-documentation/revisions/9e36b3759d5d/schema)