---
title: "Promote release"
method: POST
path: "/apps/{appName}/deployments/{deploymentName}/promote/{destDeploymentName}"
tags: ["Releases"]
---

# Promote release

`POST /apps/{appName}/deployments/{deploymentName}/promote/{destDeploymentName}`

Promotes a release from one deployment to another

## Path parameters

- `appName` string, required
- `deploymentName` string, required
- `destDeploymentName` string, required

## Headers

- `tenant` string

## Request body

- object
  - `packageInfo` PackageInfo
    - `appVersion` string — Semver or semver range
    - `description` string
    - `isDisabled` boolean
    - `isMandatory` boolean — Whether update is mandatory
    - `rollout` integer — Percentage of users to receive update
    - `label` string — Generated release label
  - `label` string — Specific release label to promote (defaults to latest)

## Response `201`

Release promoted

- object
  - `package` Package
    - `appVersion` string — Semver or semver range
    - `description` string
    - `isDisabled` boolean
    - `isMandatory` boolean — Whether update is mandatory
    - `rollout` integer — Percentage of users to receive update
    - `label` string — Generated release label
    - `blobUrl` string, uri — URL to download package
    - `packageHash` string — SHA256 hash of package
    - `size` integer — Package size in bytes
    - `uploadTime` integer — Upload timestamp
    - `releasedBy` string — Email of user who released
    - `releaseMethod` 'Upload' | 'Promote' | 'Rollback'
    - `originalLabel` string — Label of promoted/rolled back release
    - `originalDeployment` string — Name of source deployment for promotions
    - `diffPackageMap` object

## Other responses

- `403` — Forbidden - insufficient permissions
- `404` — Resource not found

---

[API](https://skmtc.net/dream-horizon-org/apis/delivr-ota-server-api.md) · [All operations](https://skmtc.net/dream-horizon-org/apis/delivr-ota-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dream-horizon-org/delivr-ota-server-api/revisions/0ad4e4284735/schema)