Provision a sandbox session
Returns 200 with a preview URL when the box is already ready or compiling (warm path). Otherwise kicks off the sandbox bring-up (VM + dev server) in the background and returns 202immediately; the client settles `ready`/`degraded` from the `sandbox_status` WS broadcast, with a status-poll fallback. Idempotent: a concurrent call joins the in-flight bring-up.
POST
/api/sandbox/sessionBody
Request
curl
curl -X POST https://trickest.io/api/sandbox/session \
-H "Authorization: Bearer $TRICKEST_TOKEN" \
-H "Content-Type: application/json" \
-d '{ }'Responses
200Already ready/compiling with preview URL (warm path)
successboolean400Bad Request – validation error or malformed input
codestringmessagestring401Unauthorized – missing or expired token
codestringmessagestring500Internal Server Error
codestringmessagestring