Retrieve paginated collection of versions matching given query optionally filtered by given project IDs.
Forge and OAuth2 apps cannot access this REST resource.
integer
string
array<integer>
integer
Returned if the versions are successfully retrieved.
1
2
3
4
curl --request GET \
--url 'http://{baseurl}/rest/api/2/version' \
--user 'email@example.com:<api_token>' \
--header 'Accept: application/json'
Creates a version.
Forge and OAuth2 apps cannot access this REST resource.
JSON containing parameters to create the version with
boolean
string
string
string
string
string
boolean
string
integer
string
Returned if the version is successfully created.
1
2
3
4
5
curl --request POST \
--url 'http://{baseurl}/rest/api/2/version' \
--user 'email@example.com:<api_token>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json'
Returns the remote version links for a given global ID.
Forge and OAuth2 apps cannot access this REST resource.
string
Returned if the remote version links are successfully retrieved.
1
2
3
4
curl --request GET \
--url 'http://{baseurl}/rest/api/2/version/remotelink' \
--user 'email@example.com:<api_token>' \
--header 'Accept: application/json'
Returns a version.
Forge and OAuth2 apps cannot access this REST resource.
string
Requiredstring
Returned if the version was found.
1
2
3
4
curl --request GET \
--url 'http://{baseurl}/rest/api/2/version/{id}' \
--user 'email@example.com:<api_token>' \
--header 'Accept: application/json'
Updates a version.
Forge and OAuth2 apps cannot access this REST resource.
string
RequiredJSON containing parameters to update the version with
boolean
string
string
string
string
string
boolean
string
integer
string
Returned if the version is successfully updated.
1
2
3
4
curl --request PUT \
--url 'http://{baseurl}/rest/api/2/version/{id}' \
--user 'email@example.com:<api_token>' \
--header 'Content-Type: application/json'
Merge versions
Forge and OAuth2 apps cannot access this REST resource.
string
Requiredstring
RequiredReturned if the version is successfully deleted.
1
2
3
curl --request PUT \
--url 'http://{baseurl}/rest/api/2/version/{id}/mergeto/{moveIssuesTo}' \
--user 'email@example.com:<api_token>'
Modify a version's sequence within a project. The move version bean has 2 alternative field value pairs:
Forge and OAuth2 apps cannot access this REST resource.
string
RequiredJSON containing parameters to move the version with
string
string
Returned if the version is successfully moved.
1
2
3
4
5
curl --request POST \
--url 'http://{baseurl}/rest/api/2/version/{id}/move' \
--user 'email@example.com:<api_token>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json'
Returns a bean containing the number of fixed in and affected issues for the given version.
Forge and OAuth2 apps cannot access this REST resource.
string
RequiredReturned if the version exists and the currently authenticated user has permission to view it.
1
2
3
4
curl --request GET \
--url 'http://{baseurl}/rest/api/2/version/{id}/relatedIssueCounts' \
--user 'email@example.com:<api_token>' \
--header 'Accept: application/json'
Delete a project version, removed values will be replaced with ones specified by the parameters.
Forge and OAuth2 apps cannot access this REST resource.
string
RequiredJSON containing parameters to replace the deleted version with
array<CustomFieldReplacement>
integer
integer
Returned if the version is successfully deleted.
1
2
3
4
curl --request POST \
--url 'http://{baseurl}/rest/api/2/version/{id}/removeAndSwap' \
--user 'email@example.com:<api_token>' \
--header 'Content-Type: application/json'
Returns the number of unresolved issues for the given version
Forge and OAuth2 apps cannot access this REST resource.
string
RequiredReturned if the version exists and the currently authenticated user has permission to view it.
1
2
3
4
curl --request GET \
--url 'http://{baseurl}/rest/api/2/version/{id}/unresolvedIssueCount' \
--user 'email@example.com:<api_token>' \
--header 'Accept: application/json'
Returns the remote version links associated with the given version ID.
Forge and OAuth2 apps cannot access this REST resource.
string
RequiredReturned if the version exists and the currently authenticated user has permission to view it.
1
2
3
4
curl --request GET \
--url 'http://{baseurl}/rest/api/2/version/{versionId}/remotelink' \
--user 'email@example.com:<api_token>' \
--header 'Accept: application/json'
Create a remote version link via POST. The link's global ID will be taken from the JSON payload if provided; otherwise, it will be generated.
Forge and OAuth2 apps cannot access this REST resource.
string
RequiredJSON containing parameters to create the remote version link with
string
string
string
Returned if the remote version link is created or updated successfully.
1
2
3
4
curl --request POST \
--url 'http://{baseurl}/rest/api/2/version/{versionId}/remotelink' \
--user 'email@example.com:<api_token>' \
--header 'Content-Type: application/json'
Delete all remote version links for a given version ID.
Forge and OAuth2 apps cannot access this REST resource.
string
RequiredReturned if the remote version links are successfully deleted.
1
2
3
curl --request DELETE \
--url 'http://{baseurl}/rest/api/2/version/{versionId}/remotelink' \
--user 'email@example.com:<api_token>'
Returns the remote version link associated with the given version ID and global ID.
Forge and OAuth2 apps cannot access this REST resource.
string
Requiredstring
RequiredReturned if the version exists and the currently authenticated user has permission to view it.
1
2
3
4
curl --request GET \
--url 'http://{baseurl}/rest/api/2/version/{versionId}/remotelink/{globalId}' \
--user 'email@example.com:<api_token>' \
--header 'Accept: application/json'
Create a remote version link via POST using the provided global ID.
Forge and OAuth2 apps cannot access this REST resource.
string
Requiredstring
RequiredJSON containing parameters to create the remote version link with
string
string
string
Returned if the remote version link is created or updated successfully.
1
2
3
4
curl --request POST \
--url 'http://{baseurl}/rest/api/2/version/{versionId}/remotelink/{globalId}' \
--user 'email@example.com:<api_token>' \
--header 'Content-Type: application/json'
Delete a specific remote version link with the given version ID and global ID.
Forge and OAuth2 apps cannot access this REST resource.
string
Requiredstring
RequiredReturned if the remote version link is successfully deleted.
1
2
3
curl --request DELETE \
--url 'http://{baseurl}/rest/api/2/version/{versionId}/remotelink/{globalId}' \
--user 'email@example.com:<api_token>'
Rate this page: