v29

latestOpenAPI 3.0.3raw.githubusercontent.com2026-05-13511526891.2 KB
Organization Fields

Update Organization Field

Updating a Dropdown (Tagger) or Multiselect Field

Dropdown and multiselect fields return an array of custom_field_options which specify the name, value, and order of dropdown or multiselect options. When updating a dropdown or multiselect field, note the following information:

  • All options must be passed on update. Options that are not passed will be removed. As a result, these values will be removed from any organizations
  • To create a new option, pass a null id along with the name and value
  • To update an existing option, pass its id along with the name and value
  • To reorder an option, reposition it in the custom_field_options array relative to the other options
  • To remove an option, omit it from the list of options upon update

Example Request

curl https://{subdomain}.zendesk.com/api/v2/organization_fields/{organization_field_id}.json \
  -H "Content-Type: application/json" -X PUT \
  -d '{"organization_field": {"custom_field_options": [{"id": 124, "name": "Option 2", "value": "option_2"}, {"id": 123, "name": "Option 1", "value": "option_1"}, {"id": 125, "name": "Option 3", "value": "option_3"}]}}' \
  -v -u {email_address}/token:{api_token}

Allowed for

  • Admins
put/api/v2/organization_fields/{organization_field_id}

Response

Success response