manage_versions

List and get project versions (releases/fixVersions).

Actions

Action	Description	Required Params	Optional Params
list	List project versions	project_key
get	Get version details	version_id
create	Create a new version	project_key, name	description, start_date, release_date

Parameters

Parameter	Type	Description
action	string	Required. list, get, or create
project_key	string	Project key (for list, create)
version_id	string	Version ID (for get)
name	string	Version name (required for create)
description	string	Version description (for create)
start_date	string	Start date YYYY-MM-DD (for create)
release_date	string	Release date YYYY-MM-DD (for create)

Examples

List versions

{
  "action": "list",
  "project_key": "PROJ"
}

Response:

{
  "total": 3,
  "versions": [
    {
      "id": "10100",
      "name": "v1.0.0",
      "description": "Initial release",
      "released": true,
      "archived": false,
      "release_date": "2024-12-01",
      "start_date": "2024-11-01"
    },
    {
      "id": "10101",
      "name": "v2.0.0",
      "released": false,
      "archived": false,
      "release_date": "2025-02-01"
    }
  ]
}

Get version details

{
  "action": "get",
  "version_id": "10101"
}

Create a version

{
  "action": "create",
  "project_key": "PROJ",
  "name": "v3.0.0",
  "description": "Major release with OAuth support",
  "start_date": "2025-02-01",
  "release_date": "2025-03-01"
}