---
title: "Review an immutable image promotion"
method: POST
path: "/platform/deployments/custom/{id}/prepare-promotion"
tags: ["Platform"]
---

# Review an immutable image promotion

`POST /platform/deployments/custom/{id}/prepare-promotion`

## Request

- Base URL: `https://api.imprezahost.com/v1`
- URL: `https://api.imprezahost.com/v1/platform/deployments/custom/{id}/prepare-promotion`
- Auth: API key in header `X-API-Key` and API key in header `X-API-Secret`

Deploy scope. Saves a fifteen-minute review from a successful owned image app pinned by sha256. Preserves destination configuration; no job or capacity reservation. Twenty pending reviews per account.

## Path parameters

- `id` string, required

## Request body

- object
  - `source_deployment_id` string, required

## Response `201`

Review with promotion_id

## Other responses

- `400`: Invalid input
- `404`: Application or current ownership unavailable
- `409`: Source or destination not eligible
- `422`: Unsupported image configuration
- `429`: Pending review quota reached
- `503`: Storage or verification unavailable

---

[API](https://skmtc.dev/imprezahost/apis/impreza-host-public-api.md) · [All operations](https://skmtc.dev/imprezahost/apis/impreza-host-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/imprezahost/apis/impreza-host-public-api/revisions/db86511f604f?raw)