Skip to main content

Rollback a deployment

POST 

/deployments/:id/rollback

Rolls back a job to a previous version.

Status: Not implemented - Planned for Phase 9 (Deployment Control APIs) Requires: Phase 5-7 (Resurrection Pattern)

What Happens

  • A new deployment is created (type: rollback)
  • Job spec is reverted to the target version
  • Rollout proceeds according to deployment strategy
  • Original deployment is marked as "rolled_back"

When to Use

  • Revert to a known-good version after issues
  • Emergency response to deployment problems
  • Testing purposes (try different versions)

Version Selection

  • If target_version is specified, rollback to that version
  • If not specified, rollback to previous version (fromVersion)

Request

Responses

OK