Create a sandbox
Creates a sandbox: one macOS user account on a fleet Mac, held for you until it closes. It is pending until a slot takes it and then ready, and bills per second from ready until it closes. An empty body gives a default headless sandbox; its worst case (timeoutMs at the hourly price) is reserved against the credit and the budget.
Authorizations
Headers
Any unique string. A retry with the same key and body within 24 hours answers 201 with what the first request made, as it is now, instead of creating again, including after a plane restart; the same key with a different body is 409 idempotency-key-reused. Failures are not remembered. Scoped to the team and the route.
1 - 255Body
Optional: an empty body is a default sandbox.
Unknown fields are refused with 400 unknown-field.
Response
The sandbox, usually pending. A replay with the same Idempotency-Key and body answers 201 with that sandbox as it is now (the same id, in its current state), with idempotent-replayed: true.
A sandbox: one Mac slot (a macOS user account) held for the team. Files persist between calls. Fields that do not apply yet are absent, not null.