create_release
Create a new release in a project to track versions and aggregate test results. Provide projectId and release name; optionally set status, dates, and version.
Instructions
Create a new release in a project. Releases track versions and aggregate manual and automated test results. projectId comes from list_projects. Omit status to default to "planned". Returns the created release with id, name, version, description, status, startDate, endDate, projectId, projectName, createdAt and updatedAt; keep the id, it is what the other release tools take. Not idempotent - calling twice with the same name creates two separate releases, so check list_releases first. When the release already exists and only its name, version, dates or status should change, use update_release instead. The new release starts empty and nothing else is modified: attach automated launches with link_launches_to_release, and attach manual executions from the execution side via the releaseIds argument of create_execution or update_execution.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Release name (e.g., "Sprint 42", "v2.1.0 Release") | |
| status | No | Optional. Release status from the project vocabulary, typically planned, in_progress, completed or cancelled, plus any the project added; call get_project for the list. Omit to use whichever value the project marks as its default. | |
| endDate | No | Target end/release date (YYYY-MM-DD) | |
| version | No | Version string (e.g., "2.1.0", "2026-Q1") | |
| projectId | Yes | Project UUID to create release in | |
| startDate | No | Release start date (YYYY-MM-DD) | |
| description | No | Detailed description of the release scope |