Project versions

Merge versions

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 instead. This resource supports swapping version values in fixVersion, affectedVersion, and custom fields.

This operation can be accessed anonymously.

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

put/rest/api/2/version/{id}/mergeto/{moveIssuesTo}

Request

  • Base URL: https://your-domain.atlassian.net
  • URL: https://your-domain.atlassian.net/rest/api/2/version/{id}/mergeto/{moveIssuesTo}
  • Auth: one of:
    • HTTP basic
    • OAuth 2 (authorization code, authorization URL https://auth.atlassian.com/authorize, token URL https://auth.atlassian.com/oauth/token, scopes: manage:jira-project)
    • none

Path parameters

idstring required

The ID of the version to delete.

moveIssuesTostring required

The ID of the version to merge into.

Response

Returned if the version is deleted.

unknown required

Changes

No recorded changes to this operation across all 26 revisions of this API.