Get a bounded sandbox-to-Live promotion plan
Requires a production br_ API key with sandbox_promotions:read and the exact studio grant. Returns public resource mappings, user-visible before/after fields, bounded warnings and errors, and version fingerprints only; it excludes provider payloads, object keys, storage identifiers, secret material, signed URLs, prices tied to customer context, and raw source documents.
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
Untrusted 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_Response
Promotion plan/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