deployments

Promote Deployment

Promote/migrate a deployment to another cluster.

This copies the deployment configuration to a new cluster without migrating any state or persistent data. The new deployment will start fresh on the target cluster.

The promotion is performed asynchronously by the worker. The new deployment is created with PROMOTING status and will transition to RUNNING when complete.

Use cases:

  • Shared vCluster → Dedicated cluster (scaling up)
  • Dedicated cluster → Dedicated cluster (region/provider change)
  • Dedicated cluster → Shared vCluster (scaling down for cost savings)
post/deployments/{deployment_id}/promote

Request

  • Base URL: https://api.mengi.cloud (the document declares no server; this is the origin it was published from)
  • URL: https://api.mengi.cloud/deployments/{deployment_id}/promote
  • Auth: none declared

Path parameters

deployment_idstring uuid required

Request body

target_cluster_idstring uuid required
new_namestring nullable
delete_sourceboolean

Response

Successful Response

source_deployment_idstring uuid required
new_deployment_idstring uuid required
target_cluster_idstring uuid required
source_deletedboolean required
messagestring required

Changes

No recorded changes to this operation across all 1 revision of this API.