Skip to main content
err:unkey:data:deployment_not_found
The deployment you referenced doesn’t exist in your workspace. You get HTTP 404.
Example response

Likely causes

  • The deployment ID has a typo. Deployment IDs start with d_.
  • Your root key can’t read the deployment. The get, promote, rollback, stop, and start endpoints return this 404 instead of a 403, so it’s as likely a permission problem as a wrong ID. A key that can read the deployment but lacks the action gets a 403 err:unkey:authorization:insufficient_permissions that names the missing permission.
  • For a redeploy with deployments.createDeployment, the source deployment is from a different app or environment.
  • The deployment is in another workspace.

How to fix

  1. List deployments with deployments.listDeployments and use the returned ID.
  2. Check that the root key has the right permission: read on the deployment for deployments.getDeployment, read on the deployment’s buildLogs for deployments.listBuildLogs, write on the deployment’s environment for deployments.promoteDeployment and deployments.rollbackDeployment, or write on the deployment for deployments.stopDeployment and deployments.startDeployment.
  3. For a redeploy, pick a deployment from the same app and environment you’re deploying to.
A deployment that exists but can’t take traffic returns a precondition error instead.
Last modified on October 28, 2026