Roll live traffic back to a previous deployment. deploymentId is the deployment to roll back TO; the app's current deployment is used as the rollback source automatically.

The target deployment must be ready, not already shutting down, belong to the production environment, and must not itself be the current deployment.

After a rollback the app is marked as rolled back, which prevents new deployments from automatically taking over live traffic. Promote the rolled-back deployment (or a newer one) to clear this state.

Rollback runs as a durable workflow: this endpoint returns once the rollback is accepted. Poll getDeployment or listDeployments to observe the result.

Required Permissions

Your root key must have write permission on the environment:

• unkey:v1:<workspace_id>:projects/<project_id>/apps/<app_id>/environments/<environment_id>#write

{
  "deploymentId": "proj_1234abcd"
}

{
  "meta": {
    "requestId": "req_123"
  }
}