API referenceComputeQuick launches
Start a quick launch
Requires the runs:create permission.
Registers a launch intent that ensures the quick-launch environment is sealed, the per-kind pool is snapshotted, and a run is forked from it. Poll GET /quick-launches/:id for progress. Prompt is required for claude/codex and must be empty for interlaken; 409 code=connector_required when the kind needs a connector and none is connected.
AuthorizationBearer <token>
An access token from this zone's POST /oauth/token, or a session token from POST /api/v1/auth/login. Send it as Authorization: Bearer <token>.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/api/v1/quick-launches" \ -H "Content-Type: application/json" \ -d '{ "kind": "string" }'{ "id": "string", "state": "string"}