Skip to content
For LLMsView as Markdown·

Launch a vendor demo game (play money) ​

http
POST https://api.onehazel.com/onehazel-api/embed/v1/{operatorId}/demo-launch

Unauthenticated and open to any origin. Body: { "key": "<connector key>", "game_code": "<game>", "language": "en", "client_type": "DESKTOP" | "MOBILE" } (language and client_type are optional). Returns { "game_url": "<https url>" } for a vendor the operator has demo-activated. It moves no money, calls no wallet and needs no player. Errors use the flat { code, message, retryable } envelope: 400 invalid_request, 404 game_unknown (no activation, or no usable demo launch) and 404 unavailable while OneHazel Surfaces is not enabled. Rate limited per client IP.

Section: Surfaces
Operation id: postEmbedV1ByOperatorIdDemoLaunch

Authentication ​

No authentication.

Parameters ​

NameInRequiredDescription
operatorIdpathyes

Request body ​

JSON object.

Responses ​

200 { "success": true, "data": ... }

Errors return { "success": false, "error": { "code": "...", "message": "..." } } with a 4xx or 5xx status.

Example ​

bash
curl -X POST "https://api.onehazel.com/onehazel-api/embed/v1/{operatorId}/demo-launch" \
  -H "Content-Type: application/json" \
  -d '{}'

Machine-readable: openapi.yaml, openapi.json.