Delete and replace version

Deletes a project version.

Alternative versions can be provided to update issues that use the deleted version in fixVersion, affectedVersion, or any version picker custom fields. If alternatives are not provided, occurrences of fixVersion, affectedVersion, and any version picker custom field, that contain the deleted version, are cleared. Any replacement version must be in the same project as the version being deleted and cannot be the version being deleted.

This operation can be accessed anonymously.

Permissions required: Administer Jira global permission or Administer Projects project permission for the project that contains the version.

curl --location --request POST 'http://jira.local:8080/jira/rest//rest/api/3/version//removeAndSwap' \ --header 'Content-Type: application/json' \ --data-raw '{ "customFieldReplacementList": [ { "customFieldId": 0, "moveTo": 0 } ], "moveAffectedIssuesTo": 0, "moveFixIssuesTo": 0 }'

Responses

🟢204Returned if the version is deleted.

application/json

Body

🟠400Returned if the request is invalid.

🟠401Returned if the authentication credentials are incorrect or missing.

🟠404Returned if: * the version to delete is not found. * the user does not have the required permissions.

Delete and replace version

Request

Responses