Deployments

Rollback Deployment

POST/v1/deployments/{slug}/rollback

Rollback a deployment to its previous champion model. This reverts the last promotion by swapping the current champion with the previous one. All active challengers are deactivated as part of the rollback. The reason is recorded in the audit log for compliance tracking.

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

Path Parameters

slugstringrequired

The deployment slug (e.g. dep_xK8m).

Body Parameters

reasonstringrequired

A description of why the rollback is being performed. Recorded in the audit log for regulatory compliance.

Error Responses

400no_rollback_target

There is no previous champion to rollback to. This occurs when the deployment has only ever had one champion model.

401unauthorized

JWT is missing or expired.

404deployment_not_found

No deployment exists with the provided slug.

Rollback Deployment

curl -X POST https://api.cali-br.com/v1/deployments/dep_xK8m/rollback \
  -H #a5d6ff">"Authorization: Bearer eyJhbGciOiJSUzI1NiIs..." \
  -H #a5d6ff">"Content-Type: application/json" \
  -d '{ #a5d6ff">"reason": "Elevated false positive rate detected in monitoring" }'

Response200

{
  "deployment_id": "dep_xK8m",
  "rolled_back_from": {
    "model_id": "mod_nY5kT2Wq",
    "version": "1.3.0-beta"
  },
  "rolled_back_to": {
    "model_id": "mod_r4Kw9xPm",
    "version": "1.2.0"
  },
  "challengers_deactivated": 0,
  "cache_version": 6
}