---
title: "update a Preboarding Candidate"
method: PUT
path: "/v1/hire/preboarding/candidates/{id}"
tags: ["PreboardingAPI"]
---

# update a Preboarding Candidate

`PUT /v1/hire/preboarding/candidates/{id}`

## Request

- Base URL: `https://{company}.keka.com/api`
- URL: `https://{company}.keka.com/api/v1/hire/preboarding/candidates/{id}`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://login.kekad.com/connect/token`

update a Preboarding Candidate

## Path parameters

- `id` string, required

## Request body

- UpdatePreboardingCandidateDTO: Model for updating preboarding candidate.
  - `firstName` string, nullable: Gets or sets the FirstName.
  - `middleName` string, nullable: Gets or sets the MiddleName.
  - `lastName` string, nullable: Gets or sets the lastName.
  - `gender` 0 | 1 | 2 | 3 | 4 | 5
  - `expectedDateOfJoining` string, date-time, nullable: Gets or sets ExpectedDateOfJoining.
  - `stage` 0 | 1 | 2 | 3 | 4 | 5

## Response `200`

Success

- boolean

## Other responses

- `401`: Unauthorized
- `403`: Forbidden

---

[API](https://skmtc.dev/keka/apis/keka-hire-api.md) - [All operations](https://skmtc.dev/keka/apis/keka-hire-api/llms.txt) - [OpenAPI document](https://skmtc.dev/keka/apis/keka-hire-api/revisions/fcf1c09be7ce?raw)