---
title: "Update custom field options (context)"
method: PUT
path: "/rest/api/3/field/{fieldId}/context/{contextId}/option"
tags: ["Issue custom field options"]
---

# Update custom field options (context)

`PUT /rest/api/3/field/{fieldId}/context/{contextId}/option`

Updates the options of a custom field.

If any of the options are not found, no options are updated. Options where the values in the request match the current values aren't updated and aren't reported in the response.

Note that this operation **only works for issue field select list options created in Jira or using operations from the [Issue custom field options](#api-group-Issue-custom-field-options) resource**, it cannot be used with issue field select list options created by Connect apps.

**[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).

## Path parameters

- `fieldId` string, required
- `contextId` integer, required

## Request body

- BulkCustomFieldOptionUpdateRequest — Details of the options to update for a custom field.
  - `options` CustomFieldOptionUpdate[] — Details of the options to update.
    - `disabled` boolean — Whether the option is disabled.
    - `id` string, required — The ID of the custom field option.
    - `value` string — The value of the custom field option.

## Response `200`

Returned if the request is successful.

- CustomFieldUpdatedContextOptionsList — A list of custom field options for a context.
  - `options` CustomFieldOptionUpdate[] — The updated custom field options.
    - `disabled` boolean — Whether the option is disabled.
    - `id` string, required — The ID of the custom field option.
    - `value` string — The value of the custom field option.

## Other responses

- `400` — Returned if the request is not valid.
- `401` — Returned if the authentication credentials are incorrect or missing.
- `403` — Returned if the user does not have the necessary permission.
- `404` — Returned if the field, context, or one or more options is not found.

---

[API](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api-2.md) · [All operations](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/the-jira-cloud-platform-rest-api-2/versions/5a51740d7ab3/schema)