Add/update candidate properties values

Set candidate properties values for the candidate's job

Below you can find a list of value examples, dependent on different candidate property types.

BOOLEAN

[{ "id": "propertyId", "value": true }]

Value has to be true or false.

COUNTRY

[{ "id": "propertyId", "value": "us" }]

Value has to be lowercase string in ISO 3166-1 alpha-2 format.

CURRENCY

[{ "id": "propertyId",
   "value": {
     "code": "GBP",
     "value": 23232
   }
 }]

Code of value is a currency code in ISO 4217 format.

DATE

[{ "id": "propertyId", "value": "2015-11-17T23:00:00.000Z" }]

NUMBER, PERCENT

[{ "id": "propertyId", "value": 42 }]

REGION

[{ "id": "propertyId", "value": "us-wa" }]

Value has to be lowercase string in ISO 3166-2 compatible format.

SINGLE_SELECT

[{ "id": "propertyId", "value": "f6fe768f-b5e6-4794-9938-c2f42ab0a572" }]

Value has to be an id of candidate property value (provided by GET /configuration/candidate-properties/{propertyId}/values).

TEXT

[{ "id": "propertyId", "value": "Example text" }]

USER

[{ "id": "propertyId", "value": "50fe861de4b00265edec6775" }]

Value has to be a valid user id

Resetting a value

To reset a value for any of the above types, please pass:

[{"id": "propertyId"}]
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

candidate identifier

string
required

job identifier

Body Params
string
required

Candidate property id, it can be:

  • candidate property uuid (e.g. 123e4567-e89b-12d3-a456-426614174000)
  • candidate property key (arbitrary string, e.g. 'myCustomFieldKey')

string, number, boolean or object depending on property

Responses
204

Properties successfully updated.

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json