---
title: "PATCH /v0.1/apps/{owner_name}/{app_name}/releases/{release_id}"
method: PATCH
path: "/v0.1/apps/{owner_name}/{app_name}/releases/{release_id}"
tags: ["distribute"]
---

# PATCH /v0.1/apps/{owner_name}/{app_name}/releases/{release_id}

`PATCH /v0.1/apps/{owner_name}/{app_name}/releases/{release_id}`

## Request

- Base URL: `https://api.appcenter.ms`
- URL: `https://api.appcenter.ms/v0.1/apps/{owner_name}/{app_name}/releases/{release_id}`
- Auth: API key in header `X-API-Token`
- TypeScript: <https://skmtc.dev/appcenter/apis/app-center-client/docs/v0.1/apps/:owner_name/:app_name/releases/:release_id/patch.ts> (a function with typed inputs; its response is checked against the schema)

Updates a release.

## Path parameters

- `release_id` integer, required
- `owner_name` string, required
- `app_name` string, required

## Request body `text/plain`

- object: A request containing information for updating a release.
  - `distribution_group_name` string: OBSOLETE. Will be removed in future releases - use destinations instead. Name of a distribution group. The release will be associated with this distribution group. If the distribution group doesn't exist a 400 is returned. If both distribution group name and id are passed, the id is taking precedence.
  - `distribution_group_id` string: OBSOLETE. Will be removed in future releases - use destinations instead. Id of a distribution group. The release will be associated with this distribution group. If the distribution group doesn't exist a 400 is returned. If both distribution group name and id are passed, the id is taking precedence.
  - `destination_name` string: OBSOLETE. Will be removed in future releases - use destinations instead. Name of a destination. The release will be associated with this destination. If the destination doesn't exist a 400 is returned. If both distribution group name and id are passed, the id is taking precedence.
  - `destination_id` string: OBSOLETE. Will be removed in future releases - use destinations instead. Id of a destination. The release will be associated with this destination. If the destination doesn't exist a 400 is returned. If both destination name and id are passed, the id is taking precedence.
  - `destination_type` string: Not used anymore.
  - `release_notes` string: Release notes for this release.
  - `mandatory_update` boolean: A boolean which determines whether this version should be a mandatory update or not.
  - `destinations` object[]: Distribute this release under the following list of destinations (store groups or distribution groups).
    - `name` string: Name of a distribution group / distribution store. The release will be associated with this distribution group or store. If the distribution group / store doesn't exist a 400 is returned. If both distribution group / store name and id are passed, the id is taking precedence.
    - `id` string: Id of a distribution group / store. The release will be associated with this distribution group / store. If the distribution group / store doesn't exist a 400 is returned. If both distribution group / store name and id are passed, the id is taking precedence.
  - `build` object: Contains metadata about the build that produced the release being uploaded
    - `branch_name` string: The branch name of the build producing the release
    - `commit_hash` string: The commit hash of the build producing the release
    - `commit_message` string: The commit message of the build producing the release
  - `notify_testers` boolean: A boolean which determines whether to notify testers of a new release, default to true.
  - `metadata` object: An object containing all the release metadata.
    - `dsa_signature` string: dsa signature of the release for the sparkle feed.
    - `ed_signature` string: edDSA signature of the release for the sparkle feed.

## Response `200`

Success

- object: Response for updating release details
  - `release_notes` string

## Other responses

- `400`: Failure
- `404`: Release not found

---

[API](https://skmtc.dev/appcenter/apis/app-center-client.md) - [All operations](https://skmtc.dev/appcenter/apis/app-center-client/llms.txt) - [OpenAPI document](https://skmtc.dev/appcenter/apis/app-center-client/revisions/4e9226ab8f35?raw)