---
title: "applyConfigPromotion"
method: POST
path: "/platform/config-promotions/{id}/apply"
tags: ["Platform"]
---

# applyConfigPromotion

`POST /platform/config-promotions/{id}/apply`

## Request

- Base URL: `https://api.imprezahost.com/v1`
- URL: `https://api.imprezahost.com/v1/platform/config-promotions/{id}/apply`
- Auth: API key in header `X-API-Key` and API key in header `X-API-Secret`

Deploy scope. Apply the exact reviewed configuration promotion with confirm: true and its review_digest. Writes the target environment's variable group (secrets re-sealed under it) and replaces each paired component's USER variables with the source's (platform-managed keys are preserved). Nothing running restarts — the change takes effect on each app's next deploy. Repeating the same promotion returns its receipt.

## Path parameters

- `id` string, required

## Request body

- object
  - `review_digest` string, required
  - `confirm` true, required

## Response `200`

Accepted receipt (replayed on repeat)

## Other responses

- `400`: Invalid confirmation or request fields
- `403`: Required scope missing
- `404`: Resource or current ownership unavailable
- `409`: Expired
- `503`: Storage unavailable; read before retrying

---

[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)