Rollback Deployment
POST
/api/deployments/{deployment_id}/rollback
Rollback a deployment.
Allowed only when the current status is INSTALLING, INSTALLED, or FAILED. Inserts a ‘force_cancel’ control_map_actions row so the next agent poll receives a cancel directive, updates firmware_deployments.status = ROLLED_BACK, and sets rolled_back_at = now(UTC).
Idempotent: if the deployment is already ROLLED_BACK the operation is a no-op and 204 is still returned.
Returns: 204 No Content on success or idempotent no-op.
Raises: HTTPException 404 if the deployment is not found or not owned by org. HTTPException 422 if the deployment is not in an allowed status.
Authorizations
Parameters
Path Parameters
deployment_id
required
string format: uuid
Query Parameters
organization_id
required
string format: uuid
Responses
204
Successful Response
422
Validation Error
object
detail
Array<object>
object
loc
required
Array
msg
required
string
type
required
string