provider Project versions PUT /rest/api/3/version/{id}
@utdk/jira /rest/api/3/version/{id}
Update version
Updates a project version. 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.
id path required
The ID of the version.
string

Try it

Authentication
Configure credentials for The Jira Cloud platform REST API
Gateway
The gateway proxies requests and injects credentials server-side. Configure credentials above, then enter your gateway URL.

Saved automatically to browser storage.

updateversion
PUT/rest/api/3/version/{id}
Updates a project version. 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.

Parameters

required

The ID of the version.

Input

If the expand option `approvers` is used, returns a list containing the approvers for this version.

Indicates that the version is archived. Optional when creating or updating a version.

The description of the version. Optional when creating or updating a version. The maximum size is 16,384 bytes.

The Atlassian account ID of the version driver. Optional when creating or updating a version. If the expand option `driver` is used, returns the Atlassian account ID of the driver.

Use [expand](em>#expansion) to include additional information about version in the response. This parameter accepts a comma-separated list. Expand options include: * `operations` Returns the list of operations available for this version. * `issuesstatus` Returns the count of issues in this version for each of the status categories *to do*, *in progress*, *done*, and *unmapped*. The *unmapped* property contains a count of issues with a status other than *to do*, *in progress*, and *done*. * `driver` Returns the Atlassian account ID of the version driver. * `approvers` Returns a list containing approvers for this version. Optional for create and update.

The ID of the version.

If the expand option `issuesstatus` is used, returns the count of issues in this version for each of the status categories *to do*, *in progress*, *done*, and *unmapped*. The *unmapped* property contains a count of issues with a status other than *to do*, *in progress*, and *done*.

The URL of the self link to the version to which all unfixed issues are moved when a version is released. Not applicable when creating a version. Optional when updating a version.

The unique name of the version. Required when creating a version. Optional when updating a version. The maximum length is 255 characters.

If the expand option `operations` is used, returns the list of operations available for this version.

Indicates that the version is overdue.

Deprecated. Use `projectId`.

The ID of the project to which this version is attached. Required when creating a version. Not applicable when updating a version.

The release date of the version. Expressed in ISO 8601 format (yyyy-mm-dd). Optional when creating or updating a version.

Indicates that the version is released. If the version is released a request to release again is ignored. Not applicable when creating a version. Optional when updating a version.

The URL of the version.

The start date of the version. Expressed in ISO 8601 format (yyyy-mm-dd). Optional when creating or updating a version.

The date on which work on this version is expected to finish, expressed in the instance's *Day/Month/Year Format* date format.

The date on which work on this version is expected to start, expressed in the instance's *Day/Month/Year Format* date format.

Enter a gateway URL above to enable sending.

Code snippet
Updates live as you fill in the form above.

TypeScript

import jira from '@utdk/jira';

await jira.updateversion()