Create version
Creates a project version.
This operation can be accessed anonymously.
Permissions required: Administer Jira global permission or Administer Projects project permission for the project the version is added to.
Request body
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 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.
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.
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.
Response
Returned if the request is successful.
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 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.
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.
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.