Delete version

Deprecated

DELETE

/rest/api/3/version/{id}

Deletes a project version.

Deprecated, use Delete and replace version that supports swapping version values in custom fields, in addition to the swapping for fixVersion and affectedVersion provided in this resource.

Alternative versions can be provided to update issues that use the deleted version in fixVersion or affectedVersion. If alternatives are not provided, occurrences of fixVersion and affectedVersion that contain the deleted version are cleared.

This operation can be accessed anonymously.

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

Request Example

Shell

JavaScript

Java

Swift

curl --location --request DELETE 'http://jira.local:8080/jira/rest//rest/api/3/version/'

Response Example

204 - Example 1

{}

Request

Path Params

string

required

The ID of the version.

Query Params

moveFixIssuesTo

string

optional

The ID of the version to update fixVersion to when the field contains the deleted version. The replacement version must be in the same project as the version being deleted and cannot be the version being deleted.

moveAffectedIssuesTo

string

optional

The ID of the version to update affectedVersion to when the field contains the deleted version. The replacement version must be in the same project as the version being deleted and cannot be the version being deleted.

Responses

🟢204Returned if the version is deleted.

application/json

Body

object {0}

🟠400Returned if the request is invalid.

🟠401Returned if: * the authentication credentials are incorrect. * the user does not have the required permissions.

🟠404Returned if the version is not found.

Modified at 2023-07-13 03:27:27

Update version

Merge versions