Promote gates
A promotion or a build dispatch came back with a refusal code. This page lists every code the platform returns, what it means, and what clears it.
Environment gates
BUILD_ENV_MISMATCH
The build's stamped environment does not match the environment bound to the target channel.
Fix: rebuild the commit in the channel's environment, or promote to a channel bound to the build's environment.
UNSTAMPED_BUILD_BLOCKED
The build predates environment stamping and carries no stamp, and the project's environments are populated, so the gate cannot place it.
Fix: rebuild the commit. New builds are stamped.
ENV_STATE_INDETERMINATE
The environment state could not be read at decision time. The gate refuses rather than guesses.
Fix: retry the promotion. If it persists, check the project's environment configuration under Environments.
Build index gates
UNKNOWN_BUILD
The sha is not in the build index. The promotion names a build the platform never produced.
Fix: build the commit first, or correct the buildId.
NO_ROLLBACK_TARGET
Returned as 409. The channel has no previous build to resolve; rollback has nowhere to go.
Fix: promote a specific build by id with POST /api/projects/{id}/releases.
REBUILD_REPLACES_LIVE_ARTIFACT
Returned as 409. The rebuild would overwrite artifacts a live channel currently serves.
Fix: pass force: true to overwrite anyway. A rebuild that takes a staging build to production is recognized as an upgrade and passes without force.
Quota gates
All quota refusals return 429 with one of these reasons.
monthly_cap
The monthly build allowance is spent.
Fix: wait for the monthly reset, or raise the plan at Plans and limits.
burst_cap
Too many dispatches inside a sliding 60 minute window.
Fix: wait. The window slides; capacity returns as older dispatches age out.
kill_switch
An operator paused dispatch. No request goes through while it holds.
Fix: none on the client. Wait for the operator to lift the pause.
counter_unavailable
The usage counter could not be read. The gate refuses rather than dispatches unmetered.
Fix: retry.
unattributed
The request could not be attributed to a billable account.
Fix: authenticate the request with an access token that belongs to the project's workspace.