Sign in

v1

latestOpenAPI 3.1.02026-07-24181585937.4 KB
Custom Field

customField.updateSelectableValues

Update the selectable values for a custom field.

This endpoint merges the provided selectable values with the existing values for a custom field.

Merge behavior:

  • New values (values not present in the existing values) are added to the field
  • Existing values (matching by value field) have their label updated and isArchived status set from the request
  • Omitted values (existing values not included in the request) are marked as archived
  • Metadata such as substitution tokens are preserved for existing values

The isArchived field defaults to false if not provided.

Requires the hiringProcessMetadataWrite permission.

post/customField.updateSelectableValues

Request body

customFieldIdstring uuid required

The id of the custom field to update

Example request

{
  "customFieldId": "e9ed20fd-d45f-4aad-8a00-a19bfba0083e"
}

Response

Responses from the customField.updateSelectableValues endpoint

OR

Example response

{
  "success": true,
  "results": {
    "id": "e9ed20fd-d45f-4aad-8a00-a19bfba0083e",
    "title": "Preferred Team",
    "description": "A description of the custom field",
    "objectType": "Application",
    "isArchived": false,
    "isPrivate": false,
    "fieldType": "String",
    "isRequired": false
  }
}