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 }'

Request

Path Params

string

required

The ID of the version.

Body Params application/json

customFieldReplacementList

array[object (CustomFieldReplacement) {2}]

optional

An array of custom field IDs (customFieldId) and version IDs (moveTo) to update when the fields contain the deleted version.

customFieldId

integer <int64>

optional

The ID of the custom field in which to replace the version number.

moveTo

integer <int64>

optional

The version number to use as a replacement for the deleted version.

moveAffectedIssuesTo

integer <int64>

optional

The ID of the version to update affectedVersion to when the field contains the deleted version.

moveFixIssuesTo

integer <int64>

optional

The ID of the version to update fixVersion to when the field contains the deleted version.

Examples

Responses

🟢204Returned if the version is deleted.

application/json

Body

No schema defined

🟠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.