Skip to main content

Promote the canary and end the rollout

POST 

/v1/projects/:project_id/agents/:agent_id/release/promote

Makes the canary version's config the agent's live config and clears the release. The canary is pinned by version, so an edit that landed mid-rollout is not promoted in its place — it stays an unreleased draft in the version history.

When the release carries a promotion_gate, the newest completed run of the eval it names that was recorded against this agent (agent_id) and pinned to the canary version (agent_version) must read verdict: supported. A newer run revokes an older one. Otherwise the call is a 409, whose meta names that run's eval_run_id, claim, verdict and verdict_reasons when there is one, and the rollout is left running untouched. The run that cleared the gate is recorded as eval_run_id on the version that goes live.

Request​

Responses​

The agent, now serving the promoted config