candidates

Update a candidate

Use this endpoint to update candidate basic information, social links and location. To update candidate properties, use the '/candidates/{id}/properties' endpoint.<br/><br/>🔑 You can access this if you have the 'candidates.update' scope activated on your secret key.

post/0/candidates/{id}

Request

  • Base URL: https://api.taleez.com
  • URL: https://api.taleez.com/0/candidates/{id}
  • Auth: API key in header X-taleez-api-secret

Path parameters

idstring required

Id of the candidate

Request body

firstNamestring required
lastNamestring required
mailstring

Candidate mail. If specified, must be unique in your company.

phonestring

Candidate phone (formats : 0611223344, +33611223344, 00336112233). Ignored if not valid.

Example request

{
  "firstName": "John",
  "lastName": "Doe",
  "mail": "john.doe@gmail.com",
  "phone": "0611223344",
  "location": {
    "country": "FR",
    "city": "Toulouse",
    "street": "Place du Capitole"
  }
}

Response

OK

Changes

No recorded changes to this operation across all 1 revision of this API.