Roll back one applied sandbox-to-Live promotion
Requires a production br_ API key with sandbox_promotions:apply, the exact studio grant, Idempotency-Key, and the applied version plus SHA-256. Content-Type must be application/json and the strict body limit is 32 KiB. Convex returns 409 when newer Live edits make rollback unsafe; clients must inspect the current plan instead of assuming an inverse change can be applied.
Authorizations
Batch Relay scoped API key or an anonymous Test Mode session. Scope names document required capabilities. Anonymous sessions are sandbox-only and do not authorize studio, event, billing, or Live Mode operations.
Headers
1 - 200Untrusted optional analytics hint naming the calling client surface. It never affects authorization, routing, pricing, or behavior.
1 - 100Untrusted optional analytics hint naming the calling client version. It never affects authorization, routing, pricing, or behavior.
1 - 100Untrusted optional analytics hint naming the invocation mode. It never affects authorization, routing, pricing, or behavior.
1 - 100Path Parameters
Stable public studio ID beginning with stu_. The API never selects a studio implicitly; a local CLI profile name is not a studio ID.
5 - 256^stu_[A-Za-z0-9_-]+$Opaque public promotion identifier.
5 - 256^spr_Body
Response
Rolled-back promotion status
An immutable, bounded review and lifecycle record. It never returns secret material, storage IDs/object keys, signed URLs, raw source documents, provider payloads, or customer-context prices. status is authoritative; lifecycle is a compatibility duplicate. preparing is a current state only: trusted internal media staging must settle before apply, without promising asynchronous readiness or byte-copy behavior to the API caller.
5 - 256^spr_1 - 3 elementsforms, catalog, storefront ^[a-f0-9]{64}$x >= 1250preparing, ready, applying, applied, conflicted, failed, rolled_back, expired 5 - 256^stu_^[a-f0-9]{64}$x >= 11001 - 1000801000preparing, ready, applying, applied, conflicted, failed, rolled_back, expired 2501001 - 1000