---
title: "Delete version"
method: DELETE
path: "/rest/api/2/version/{id}"
tags: ["Project versions"]
deprecated: true
---

# Delete version

`DELETE /rest/api/2/version/{id}`

> **Deprecated.**

Deletes a project version.

Deprecated, use [ Delete and replace version](#api-rest-api-2-version-id-removeAndSwap-post) 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](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg) or *Administer Projects* [project permission](https://confluence.atlassian.com/x/yodKLg) for the project that contains the version.

## Path parameters

- `id` string, required

## Query parameters

- `moveFixIssuesTo` string
- `moveAffectedIssuesTo` string

## Response `204`

Returned if the version is deleted.

## Other responses

- `400` — Returned if the request is invalid.
- `401` — Returned if: * the authentication credentials are incorrect. * the user does not have the required permissions.
- `404` — Returned if the version is not found.

---

[API](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api.md) · [All operations](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/the-jira-cloud-platform-rest-api/versions/a26541c2f8bd/schema)