Deployments

Promote Challenger

POST/v1/deployments/{slug}/promote

Promote a challenger model to become the new champion on a deployment. The current champion is moved to the previous champion slot (available for rollback), and all other active challengers are deactivated. This is an atomic operation — all scoring traffic switches to the new champion immediately.

Authentication: JWT token. Requires role: owner or admin.

Path Parameters

slugstringrequired

The deployment slug (e.g. dep_xK8m).

Body Parameters

challenger_idstringrequired

The challenger entry ID to promote to champion (e.g. ch_abc123), not the model ID.

Error Responses

401unauthorized

JWT is missing or expired.

404challenger_not_found

No active challenger with the provided ID exists on this deployment.

Promote Challenger

curl -X POST https://api.cali-br.com/v1/deployments/dep_xK8m/promote \
  -H #a5d6ff">"Authorization: Bearer eyJhbGciOiJSUzI1NiIs..." \
  -H #a5d6ff">"Content-Type: application/json" \
  -d '{ #a5d6ff">"challenger_id": "ch_abc123" }'

Response200

{
  "deployment_id": "dep_xK8m",
  "promoted_model_id": "mod_nY5kT2Wq",
  "previous_champion_id": "mod_r4Kw9xPm",
  "challengers_deactivated": 1,
  "cache_version": 5
}