---
title: "Update a candidate"
method: PUT
path: "/candidates/{id}"
tags: ["Candidates"]
---

# Update a candidate

`PUT /candidates/{id}`

## Path parameters

- `id` number, required

## Request body

- object
  - `first_name` string, required
  - `middle_name` string
  - `last_name` string, required
  - `title` string — The candidate's job title.
  - `address` object — An object containing the address for the candidate with the following structure: ``` { "street": "<street>", "city": "<city>", "state": "<state>", "postal_code": "<postal code>" } ```
    - `street` string
    - `city` string
    - `state` string
    - `postal_code` string
  - `country_code` string
  - `social_media_urls` unknown[]
    - unknown
  - `website` string
  - `best_time_to_call` string
  - `current_employer` string
  - `date_available` string — The date the candidate is available for an opening.
  - `current_pay` string
  - `desired_pay` string
  - `is_willing_to_relocate` boolean
  - `key_skills` string
  - `notes` string
  - `source` string
  - `owner_id` number — The user id of the record owner
  - `is_active` boolean — A flag indicating if the candidate is active.
  - `is_hot` boolean — A flag indicating if the candidate should be marked as hot. A hot candidate is highlighted in the candidates view.
  - `password` string — The candidate's password if they are "registering". Registered candidate can be authenticated with `/candidates/authorization`.
  - `custom_fields` unknown[] — An array of custom field objects. Each custom field object should contain two keys: `id` and `value`. `id` is the id of a custom field definition, and `value` is the value to be set to that custom field for this candidate. ``` [ { "id": <custom field definition id>, "value": "<custom field value>" } ] ```
    - unknown

## Response `204`

No Content

---

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