---
title: "Merge versions"
method: PUT
path: "/rest/api/2/version/{id}/mergeto/{moveIssuesTo}"
tags: ["Project versions"]
---

# Merge versions

`PUT /rest/api/2/version/{id}/mergeto/{moveIssuesTo}`

Merges two project versions. The merge is completed by deleting the version specified in `id` and replacing any occurrences of its ID in `fixVersion` with the version ID specified in `moveIssuesTo`.

Consider using [ Delete and replace version](#api-rest-api-2-version-id-removeAndSwap-post) instead. This resource supports swapping version values in `fixVersion`, `affectedVersion`, and custom fields.

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
- `moveIssuesTo` string, required

## Response `204`

Returned if the version is deleted.

- unknown

## Other responses

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

---

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