Recruiting

Update an existing candidate. You can include custom fields in the body of the request.

put/recruiting/candidates/{candidateId}

Request

Base URL
https://sandbox-api.kenjo.io/api/v1
Auth
none declared
TypeScript
https://skmtc.dev/kenjo/apis/kenjo-api/docs/recruiting/candidates/:candidateId/put.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

candidateIdstring required

Request body

firstNamestring

lastNamestring

emailstring

phonestring

sourceFieldstring

Example request

{
  "firstName": "Johannes",
  "lastName": "Hesse",
  "email": "johannes.hesse@test.com",
  "sourceField": "Website integration"
}

Response

_idstring

The _id of the candidate just created.

firstNamestring

The name of the candidate created.

lastNamestring

The last name of the candidate created.

phonestring

The phone of the candidate created.

sourceFieldstring

The source field of the candidate.

originstring

The source of the entry (e.g., API, manual, agency, browserExtension).

_createdByIdstring

The unique identifier of the creator of the record.

_updatedByIdstring

The unique identifier of the updater of the record.

_createdAtstring date-time

The creation date of the record in ISO 8601 format.

_updatedAtstring date-time

The last update date of the record in ISO 8601 format.

Example response

{
  "_id": "6751ebdf7d91779514cebbcd",
  "firstName": "Johannes",
  "lastName": "Hesse",
  "sourceField": "Website integration",
  "origin": "api",
  "_createdById": "67223a2a77fb00d3fb70cbac",
  "_updatedById": "67223a2a77fb00d3fb70cbac",
  "_createdAt": "2024-11-29T10:02:41.345Z",
  "_updatedAt": "2024-11-29T10:22:31.141Z"
}

Changes

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