---
title: "Set a candidate status"
method: PUT
path: "/candidates/{candidateId}/status"
tags: ["Candidate API:Candidates"]
---

# Set a candidate status

`PUT /candidates/{candidateId}/status`

Change the candidate status and add an optional note

## Path parameters

- `candidateId` integer, required

## Request body

- SetCandidateStatusCommand
  - `statusId` integer, required — Status Id
  - `note` SubmitStatusNoteModel — Optional note
    - `type` string, nullable — Optional note type
    - `text` string, nullable — Note content

## Response `200`

Candidate status was successfully updated

## Other responses

- `202` — Candidate status already assigned
- `404` — Candidate was not found
- `422` — Validation error

---

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