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/session

Body

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)

successboolean

400Bad Request – validation error or malformed input

codestringrequired

messagestringrequired

detailsobject