Replace custom field options

DELETE

/rest/api/3/field/{fieldId}/context/{contextId}/option/{optionId}/issue

Replaces the options of a custom field.

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

Permissions required: Administer Jira global permission.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request DELETE '/rest/api/3/field//context//option//issue'

Response Example

303 - Success

{"self":"https://your-domain.atlassian.net/rest/api/3/task/1","id":"1","description":"Remove option 1 from issues matched by '*', and replace with option 3","status":"COMPLETE","result":{"errors":{"errorMessages":["Option 2 cannot be set on issue MKY-5 as it is not in the correct scope"],"errors":{},"httpStatusCode":{"empty":false,"present":true}},"modifiedIssues":[10001,10010],"unmodifiedIssues":[10005]},"elapsedRuntime":42}

Request

Path Params

Query Params

Responses

🔵303303

application/json

Returned if the long-running task to deselect the option is started.

Body

🟠400Bad Request

🟠403Forbidden

🟠404Record Not Found

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

Delete custom field options (context)

Get all dashboards