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

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

`PUT /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/put.ts> (a function with typed inputs; its response is checked against the schema)

Update details of a release.

## Path parameters

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

## Request body

- object: A request containing information for updating details of a release
  - `enabled` boolean: Toggle this release to be enable distribute/download or not.
  - `release_notes` string: Release notes for this release.
  - `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

## Response `200`

Success

- object: Response for updating a release
  - `enabled` boolean
  - `mandatory_update` boolean
  - `release_notes` string
  - `provisioning_status_url` string
  - `destinations` object[]
    - `id` string
    - `name` 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)