---
title: "Promote staging to production"
method: POST
path: "/v1/apps/{app_id}/promote"
tags: ["Apps"]
---

# Promote staging to production

`POST /v1/apps/{app_id}/promote`

Promote the current staging deployment to production.

Copies `environments.staging` (deploy_id, asset_prefix) to
`environments.production` and updates `build_config.asset_prefix`
for backward compatibility. Also invalidates the canvas asset cache
so the new production version is served immediately.

## Path parameters

- `app_id` string, required — App ID (e.g. app_abc123def456)

## Response `200`

Successful Response

- PromoteResponse — Response after promoting staging to production.
  - `app_id` string, required
  - `version` integer, nullable
  - `deploy_id` string, required
  - `environment` string
  - `asset_prefix` string, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/mixpeek/apis/mixpeek-api.md) · [All operations](https://skmtc.net/mixpeek/apis/mixpeek-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mixpeek/mixpeek-api/revisions/c768d4d28e4c/schema)