Hanzo AI
OpenapiSandbox

Create ticket

Mints a short-lived grant to open the screen of a desktop sandbox.

POST /v1/sandbox/{id}/screen/ticket

Addresshttps://api.hanzo.ai/v1/sandbox/{id}/screen/ticket
MethodPOST
Operationpost_sandbox_by_id_screen_ticket
AuthAuthorization: Bearer $HANZO_API_KEY

Mints a short-lived grant to open the screen of a desktop sandbox. Same properties as the terminal ticket, for the other endpoint.

Request

1 field.

FieldInTypeRequiredDescription
idpathstringyesID is the sandbox to address, from the path.

Response

StatusBodyMeaning
201ticketGrantcreated

201 body — 3 fields.

FieldInTypeAlwaysDescription
expiresInbodyintegerExpiresIn is how long the ticket is good for, in seconds.
ticketbodystringTicket is the grant itself. It is single-purpose and short-lived, and it travels in a query string because a WebSocket handshake carries no Authorization…
urlbodystringURL is the PATH to open, ticket included — not an absolute URL.

Failure carries the platform error shape — see Errors.

Examples

hanzo sandbox screen ticket <id>

Sandbox API · All Hanzo APIs · Interactive reference

How is this guide?

On this page