---
title: "Update the release."
method: PATCH
path: "/apps/{appId}/releases/{releaseId}"
tags: ["releases"]
---

# Update the release.

`PATCH /apps/{appId}/releases/{releaseId}`

## Request

- Base URL: `https://api.shorebird.dev/api/v1`
- URL: `https://api.shorebird.dev/api/v1/apps/{appId}/releases/{releaseId}`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

## Request body

- UpdateReleaseRequest: The request body for PATCH /apps/{appId}/releases/{releaseId}.
  - `status` 'draft' | 'active': The status of a release.
  - `platform` 'android' | 'ios' | 'linux' | 'macos' | 'windows': A platform to which a Shorebird release can be deployed.
  - `metadata` object: Additional information about the command that was run to update the release and the environment it was run in.
  - `notes` string: Notes about the release. This is a free-form field that can be used to store additional information about the release. If null, the notes will not be updated.

## Response `204`

The release was updated.

## Other responses

- `422`: The release's Flutter revision is marked bad at the block level for this platform, and the request moves the platform to `draft` or `active` (`flutter_revision_blocked`). The message names the revision, the platform, what is wrong and, when known, the Flutter revision to release with instead. A mark that only warns never refuses.
- `default`: Standard error response. Emitted for any non-2xx status where a body can be decoded into an [ErrorResponse].

---

[API](https://skmtc.dev/shorebird/apis/shorebird-codepush-api.md) - [All operations](https://skmtc.dev/shorebird/apis/shorebird-codepush-api/llms.txt) - [OpenAPI document](https://skmtc.dev/shorebird/apis/shorebird-codepush-api/revisions/941da8871d10?raw)