# Jira Project versions API

**Canonical:** https://apis.io/apis/jira/jira-project-versions-api/  
**Provider:** Jira — https://apis.io/providers/jira/  
**Base URL:** https://your-domain.atlassian.net/rest/api/2  
**Documentation:** https://developer.atlassian.com/cloud/jira/platform/rest/v2/intro/

Jira Project versions API is one of 132 APIs that [Jira](https://apis.io/providers/jira/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Project Versions. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, and an API reference.

This resource represents project versions. Use it to get, get lists of, create, update, move, merge, and delete project versions. This resource also provides counts of issues by version.

## Operations (15)

| Method | Path | Summary |
|---|---|---|
| GET | `/rest/api/3/project/{projectIdOrKey}/version` | Get project versions paginated |
| GET | `/rest/api/3/project/{projectIdOrKey}/versions` | Get project versions |
| POST | `/rest/api/3/version` | Create version |
| DELETE | `/rest/api/3/version/{id}` | Delete version |
| GET | `/rest/api/3/version/{id}` | Get version |
| PUT | `/rest/api/3/version/{id}` | Update version |
| PUT | `/rest/api/3/version/{id}/mergeto/{moveIssuesTo}` | Merge versions |
| POST | `/rest/api/3/version/{id}/move` | Move version |
| GET | `/rest/api/3/version/{id}/relatedIssueCounts` | Get version's related issues count |
| GET | `/rest/api/3/version/{id}/relatedwork` | Get related work |
| POST | `/rest/api/3/version/{id}/relatedwork` | Create related work |
| PUT | `/rest/api/3/version/{id}/relatedwork` | Update related work |
| POST | `/rest/api/3/version/{id}/removeAndSwap` | Delete and replace version |
| GET | `/rest/api/3/version/{id}/unresolvedIssueCount` | Get version's unresolved issues count |
| DELETE | `/rest/api/3/version/{versionId}/relatedwork/{relatedWorkId}` | Delete related work |

## Machine-readable artifacts (6)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/jira/refs/heads/main/openapi/jira-project-versions-api-openapi.yml
- **Documentation** — https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/
- **Authentication** — https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/#authentication
- **Documentation** — https://developer.atlassian.com/cloud/jira/software/rest/intro/
- **Documentation** — https://developer.atlassian.com/cloud/jira/service-desk/rest/intro/
- **APIReference** — https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/

## Other Jira APIs (12)

- [Jira Cloud Platform REST API v2](https://apis.io/apis/jira/jira-cloud-platform-rest-api-v2/)
- [Jira Service Management Operations REST API](https://apis.io/apis/jira/jira-service-management-operations-rest-api/)
- [Jira Align REST API](https://apis.io/apis/jira/jira-align-rest-api/)
- [Jira Customer Service Management REST API](https://apis.io/apis/jira/jira-customer-service-management-rest-api/)
- [Jira Issue Comments API](https://apis.io/apis/jira/jira-issue-comments-api/)
- [Jira Issue Priorities API](https://apis.io/apis/jira/jira-issue-priorities-api/)
- [Jira Issue Search API](https://apis.io/apis/jira/jira-issue-search-api/)
- [Jira Issue Statuses API](https://apis.io/apis/jira/jira-issue-statuses-api/)
- [Jira Issue Transitions API](https://apis.io/apis/jira/jira-issue-transitions-api/)
- [Jira Issue Types API](https://apis.io/apis/jira/jira-issue-types-api/)
- [Jira Issues API](https://apis.io/apis/jira/jira-issues-api/)
- [Jira Projects API](https://apis.io/apis/jira/jira-projects-api/)

## Tags

Project Versions

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/jira/jira-project-versions-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/jira/.