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

# PATCH /candidates/{id}/

`PATCH /candidates/{id}/`

## Request

- Base URL: `https://api.manatal.com/open/v3`
- URL: `https://api.manatal.com/open/v3/candidates/{id}/`
- Auth: API key in header `Authorization`

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.dev/manatal/apis/manatal-open-api.md) - [All operations](https://skmtc.dev/manatal/apis/manatal-open-api/llms.txt) - [OpenAPI document](https://skmtc.dev/manatal/apis/manatal-open-api/revisions/564633b3d03b?raw)