---
title: "PATCH /candidates/{id}/"
method: PATCH
path: "/candidates/{id}/"
tags: ["candidates"]
---

# PATCH /candidates/{id}/

`PATCH /candidates/{id}/`

Update partially a candidate details.

## Request body

- object
  - `id` integer
  - `external_id` string, nullable — Id of the candidate in the API consumer systems
  - `full_name` string, required — Full name of the candidate
  - `creator` integer — User who created the candidate
  - `owner` integer, nullable — ID of the owner of the candidate - default to creator if none is provided
  - `source_type` 'sourced' | 'applied' | 'referred' | 'agency' | 'other' — Origin of the candidate
  - `source_other` string, nullable — Field to add manual information to the source if the source_type is other
  - `consent` boolean, nullable — Whether the candidate gave permission to use his data (GDPR,Brazil's LGPD, USA´s CCPA ...)
  - `consent_date` string, date-time — Date at which the candidate gave his consent
  - `picture` string, uri — Link to the candidate picture
  - `email` string, email, nullable — Candidate email
  - `resume` string — Link to the candidate resume
  - `phone_number` string, nullable — Candidate phone number
  - `gender` 'male' | 'female' | 'other' | 'unknown', nullable — Gender of the candidate
  - `birth_date` string, date, nullable — Candidate birth date
  - `address` string — Full address of the candidate
  - `zipcode` string — Code for the city of the address field
  - `latest_degree` string, nullable — Latest degree obtained by the candidate
  - `latest_university` string, nullable — Latest university the candidate graduated from
  - `current_company` string, nullable — Company where the candidate currently works
  - `current_department` string, nullable — Department where the candidate works
  - `current_position` string, nullable — Position of the candidate at his current job
  - `description` string — Description of the candidate - can only input text here.
  - `hash` string — Unique hash of the candidate
  - `custom_fields` object — Candidate values for custom fields defined in Manatal.
  - `created_at` string, date-time — Date at which the candidate was created
  - `updated_at` string, date-time

## Response `200`

- object
  - `id` integer
  - `external_id` string, nullable — Id of the candidate in the API consumer systems
  - `full_name` string, required — Full name of the candidate
  - `creator` integer — User who created the candidate
  - `owner` integer, nullable — ID of the owner of the candidate - default to creator if none is provided
  - `source_type` 'sourced' | 'applied' | 'referred' | 'agency' | 'other' — Origin of the candidate
  - `source_other` string, nullable — Field to add manual information to the source if the source_type is other
  - `consent` boolean, nullable — Whether the candidate gave permission to use his data (GDPR,Brazil's LGPD, USA´s CCPA ...)
  - `consent_date` string, date-time — Date at which the candidate gave his consent
  - `picture` string, uri — Link to the candidate picture
  - `email` string, email, nullable — Candidate email
  - `resume` string — Link to the candidate resume
  - `phone_number` string, nullable — Candidate phone number
  - `gender` 'male' | 'female' | 'other' | 'unknown', nullable — Gender of the candidate
  - `birth_date` string, date, nullable — Candidate birth date
  - `address` string — Full address of the candidate
  - `zipcode` string — Code for the city of the address field
  - `latest_degree` string, nullable — Latest degree obtained by the candidate
  - `latest_university` string, nullable — Latest university the candidate graduated from
  - `current_company` string, nullable — Company where the candidate currently works
  - `current_department` string, nullable — Department where the candidate works
  - `current_position` string, nullable — Position of the candidate at his current job
  - `description` string — Description of the candidate - can only input text here.
  - `hash` string — Unique hash of the candidate
  - `custom_fields` object — Candidate values for custom fields defined in Manatal.
  - `created_at` string, date-time — Date at which the candidate was created
  - `updated_at` string, date-time

---

[API](https://skmtc.net/manatal/apis/manatal-career-page-api.md) · [All operations](https://skmtc.net/manatal/apis/manatal-career-page-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/manatal/manatal-career-page-api/versions/59053f2da83c/schema)