Update issue field option

PUT

/rest/api/3/field/{fieldKey}/option/{optionId}

Updates or creates an option for a select list issue field. This operation requires that the option ID is provided when creating an option, therefore, the option ID needs to be specified as a path and body parameter. The option ID provided in the path and body must be identical.

Note that this operation only works for issue field select list options added by Connect apps, it cannot be used with issue field select list options created in Jira or using operations from the Issue custom field options resource.

Permissions required: Administer Jira global permission. Jira permissions are not required for the app providing the field.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT '/rest/api/3/field//option/' \
--header 'Content-Type: application/json' \
--data-raw 'Team 1'

Response Example

{"id":1,"value":"Team 1","properties":{"leader":{"name":"Leader Name","email":"lname@example.com"},"members":42,"description":"The team's description","founded":"2016-06-06"},"config":{"scope":{"projects":[],"projects2":[{"id":1001,"attributes":["notSelectable"]},{"id":1002,"attributes":["notSelectable"]}],"global":{}},"attributes":[]}}

Request

Path Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

Returned if the option is updated or created.

Body

🟠400Bad Request

🟠403Forbidden

🟠404Record Not Found

Modified at 2025-07-16 07:18:01

Get issue field option

Replace issue field option