Provision Sandbox

View as MarkdownOpen in Claude
Provision a new sandbox environment.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Headers

x-workspace-idstring or nullOptional

Request

This endpoint expects an object.
task_idstringRequired1-255 characters
env_varsmap from strings to strings or nullOptional
imagestring or nullOptional1-512 characters
image_idstring or nullOptionalformat: "uuid"
ttl_secondsinteger or nullOptional60-86400

Response

Successful Response
successboolean
errorstring or null
sandbox_idstring or nullformat: "uuid"
sandbox_urlstring or null
statusstringDefaults to provisioning

Errors

422
Unprocessable Entity Error