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 eval it names must have a run that finished completed with passed: true and was pinned to the canary version (agent_version); otherwise the call is a 409 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