---
title: "Update release"
method: PUT
path: "/api/projects/{projectId}/releases/{releaseId}"
tags: ["Release"]
---

# Update release

`PUT /api/projects/{projectId}/releases/{releaseId}`

Update the name, description, or tags of an existing release.

## Path parameters

- `projectId` string, uuid, required
- `releaseId` string, uuid, required

## Request body

- object
  - `name` string, nullable — Updated release name
  - `description` string, nullable — Updated release description
  - `tags` string[], nullable — Release tags

## Response `200`

Updated release information

- object — Updated release information
  - `id` string, uuid, required — Release unique identifier
  - `createdAt` string, required — Release creation timestamp
  - `deletedAt` string, nullable — Release deletion timestamp
  - `name` string, nullable — Release name
  - `description` string, nullable — Release description
  - `version` number, nullable — Legacy numeric version
  - `semanticVersion` string, nullable — Semantic version (e.g., 1.0.0)
  - `status` 'draft' | 'published' | 'completed' — Release status
  - `projectId` string, uuid, required — Project ID the release belongs to
  - `createdById` string, uuid, nullable — ID of the user who created the release
  - `commitId` string, uuid, nullable — Associated commit ID
  - `meta` object, nullable — Release storage metadata
    - `bucket` string — Storage bucket name
    - `key` string — Storage object key

---

[API](https://skmtc.dev/gorules/apis/gorules-agent-api.md) · [All operations](https://skmtc.dev/gorules/apis/gorules-agent-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gorules/gorules-agent-api/revisions/52c0773fcd80/schema)