Skip to navigation

Create a managed sandbox deployment

Records durable deployment intent and reserves organization capacity. 202 means the intent and its operation are persisted; readiness and ingress are reported separately.

Authentication

AuthorizationBearer
API key or Clerk session token

Headers

idempotency-keystringOptional
Replays the stored response for the same authored body for seven days. Reusing a key with a different body returns 409.

Request

This endpoint expects an object.
objectRequired
OR
objectRequired

Response

Deployment intent accepted
deploymentobject
operationIdstring or null

Errors

400
Bad Request Error
401
Unauthorized Error
402
Payment Required Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
412
Precondition Failed Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error