---
title: "/candidates/:id"
method: PATCH
path: "/c/{company_id}/candidates/{id}"
---

# /candidates/:id

`PATCH /c/{company_id}/candidates/{id}`

## Request

- Base URL: `https://api.recruitee.com`
- URL: `https://api.recruitee.com/c/{company_id}/candidates/{id}`
- Auth: OAuth 2

Update a candidate with provided ID.

Watch out when testing the endpoint here! It will update found resources!

## Path parameters

- `company_id` integer, required
- `id` string, required

## Headers

- `Content-Type` string

## Request body

- object
  - `candidate` object
    - `name` string: Candidate name
    - `remote_cv_url` string: Link to file saved on some external website. You can use candidate[cv] instead if you want to upload a file.
    - `emails` string[]: Array of emails
    - `phones` string[]: Array of phone numbers
    - `social_links` string[]: Array of social links
    - `links` string[]: Array of links
    - `cover_letter` string: Candidate's cover letter

## Response `200`

200

- object
  - `candidate` object
    - `ratings_count` integer
    - `phones` string[]
    - `created_at` string
    - `admin_ids` unknown[]
      - unknown
    - `ratings` object
    - `name` string
    - `sourcing_origin` unknown
    - `admin_id` integer
    - `referral_referrers_ids` unknown[]
      - unknown
    - `emails` string[]
    - `pending_request_link` boolean
    - `my_pending_result_request` boolean
    - `gdpr_expires_at` unknown
    - `social_links` string[]
    - `cover_letter` string
    - `in_active_share` boolean
    - `my_last_rating` unknown
    - `sources` unknown[]
      - unknown
    - `gdpr_consent_ever_given` boolean
    - `updated_at` string
    - `photo_url` string
    - `tags` unknown[]
      - unknown
    - `id` integer
    - `viewed` boolean
    - `referrer` unknown
    - `cv_processing_status` string
    - `duplicates` integer[]
    - `gdpr_consent_request_completed_at` unknown
    - `online_data` unknown
    - `mailbox_messages_count` integer
    - `cv_original_url` unknown
    - `cv_url` unknown
    - `rating` integer
    - `photo_thumb_url` string
    - `sourcing_data` unknown
    - `last_activity_at` string
    - `gdpr_consent_request_type` unknown
    - `source` string
    - `upcoming_event` boolean
    - `positive_ratings` unknown
    - `gdpr_consent_request_sent_at` unknown
    - `unread_notifications` boolean
    - `custom_fields` unknown[]
      - unknown
    - `open_question_answers` unknown[]
      - unknown
    - `links` string[]
    - `gdpr_status` string
    - `tasks_count` integer
    - `attachments_count` integer
    - `grouped_open_question_answers` unknown[]
      - unknown
    - `last_message_at` unknown
    - `example` boolean
    - `gdpr_scheduled_to_delete_at` unknown
    - `placements` unknown[]
      - unknown
    - `pending_result_request` boolean
    - `adminapp_url` string
    - `fields` object[]
      - `fixed` boolean
      - `id` unknown
      - `kind` string
      - `origin` string
      - `values` unknown[]
        - unknown
      - `visibility` object
        - `admin_ids` unknown[]
          - unknown
        - `level` string
        - `role_ids` unknown[]
          - unknown
      - `visible` boolean
    - `followed` boolean
    - `my_upcoming_event` boolean
    - `notes_count` integer
  - `references` object[]
    - `email` string
    - `first_name` string
    - `id` integer
    - `last_name` string
    - `offer_ids` unknown
    - `photo_normal_url` string
    - `photo_thumb_url` string
    - `time_format24` boolean
    - `timezone` string
    - `type` string
    - `view_all_jobs` boolean

## Other responses

- `422`: 422

---

[API](https://skmtc.dev/recruitee/apis/ats-api.md) - [All operations](https://skmtc.dev/recruitee/apis/ats-api/llms.txt) - [OpenAPI document](https://skmtc.dev/recruitee/apis/ats-api/revisions/92a80d21a7e0?raw)