Schedule a studio offer
Schedule requires a future starts_at and an expected revision. The durable offer service owns the transition and activation time.
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_-]+$Body
x >= 1Optional schedule end; when set it must match the immutable revision terms.
500Required for activate and schedule; the provisioned immutable revision to transition.
1 - 240Required and future-dated for schedule.
Response
Scheduled studio offer
automatic, code "USD"percent, fixed pending, processing, succeeded, failed, uncertain, unsupported x >= 1Immutable candidate revision ID to pass to activate or schedule.
1draft, scheduled, active, paused, expired, exhausted, revoked, sync_error