Update Organization Field
PUT {{baseUrl}}/api/v2/organization_fields/:organization_field_id
Updating a Drop-down (Tagger) Field
Drop-down fields return an array of custom_field_options
which specify the name, value, and order of drop-down options. When updating a drop-down 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 thename
andvalue
- To update an existing option, pass its
id
along with thename
andvalue
- 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}:{password}
Allowed for
- Admins
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"organization_field":{"active":true,"created_at":"2013-02-27T20:35:55Z","description":"This field describes the support plan this organization has","id":75,"key":"support_description","position":0,"raw_description":"This field describes the support plan this organization has","raw_title":"Support description","regexp_for_validation":null,"title":"Support description","type":"text","updated_at":"2013-02-27T20:35:55Z","url":"https://company.zendesk.com/api/v2/organization_fields/75.json"}}