---
title: "Replace issue field option"
method: DELETE
path: "/rest/api/3/field/{fieldKey}/option/{optionId}/issue"
tags: ["Issue custom field options (apps)"]
---

# Replace issue field option

`DELETE /rest/api/3/field/{fieldKey}/option/{optionId}/issue`

Deselects an issue-field select-list option from all issues where it is selected. A different option can be selected to replace the deselected option. The update can also be limited to a smaller set of issues by using a JQL query.

Connect and Forge app users with *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg) can override the screen security configuration using `overrideScreenSecurity` and `overrideEditableFlag`.

This is an [asynchronous operation](#async). The response object contains a link to the long-running task.

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](#api-group-Issue-custom-field-options) resource.

**[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg). Jira permissions are not required for the app providing the field.

## Path parameters

- `fieldKey` string, required
- `optionId` integer, required

## Query parameters

- `replaceWith` integer
- `jql` string
- `overrideScreenSecurity` boolean
- `overrideEditableFlag` boolean

## Other responses

- `303` — Returned if the long-running task to deselect the option is started.
- `400` — Returned if the request is not valid.
- `403` — Returned if the user does not have the necessary permission.
- `404` — Returned if the field is not found or does not support options, or the options to be replaced are 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)