Sign in

v1

latestOpenAPI 3.1.02026-07-261770816.7 KB
Custom Field Options

Update custom field option

Edit the display label, sort order, or external id of an existing custom field option. The parent custom_field_id cannot be moved through this endpoint — options stay attached to the field they were created under. Renaming an option to collide with an archived option's name returns 422; to reactivate an archived option, POST a new option with its name instead.

patch/v3/custom_field_options/{id}

Path parameters

idinteger required

Request body

namestring

New display label for the option. Must be unique among active options on the same custom field; renaming to collide with an archived option's name returns 422 — POST a new option with that name to reactivate it instead.

sort_orderinteger

New display position within the dropdown. Lower values render first. Partners reorganizing dropdowns typically PATCH sort_order on every affected option in a single bulk update.

external_idstring

New caller-supplied identifier from the partner's source system. Send an empty string to clear a previously stored value.

Response

Successful

idinteger
created_atstring date-time
updated_atstring date-time
custom_field_idinteger

Id of the parent custom field this option belongs to. Only fields with value_type of single_select or multi_select carry options.

namestring

Display label shown to recruiters and hiring managers in dropdowns (e.g. Engineering, Bachelor's, Stanford University). Unique among active options on the same parent custom field.

external_idstring nullable

Caller-supplied identifier from the partner's source system (typically an HRIS row id or legacy ATS id). Persisted verbatim as the column offsite_hris_id and not interpreted by Greenhouse.

sort_orderinteger

Display position within the parent custom field's dropdown. Lower values render first; ties fall back to insertion order. Alias of priority in V1/V2.

activeboolean

true while the option is selectable. Set to false after deletion — historical selections on candidates, jobs, and offers are preserved so the value still resolves on existing records.