{"name":"BizQiz","description":"Live multiplayer trivia games for events. Find what is playing now and how to join.","url":"https://play.bizqiz.com","api":{"type":"openapi","url":"https://play.bizqiz.com/openapi.json"},"auth":{"type":"none","instructions":"Reading games requires no authentication."},"agentAuth":{"type":"apiKey","in":"header","scheme":"Bearer","keyPrefix":"bzq_live_","description":"Agent clients authenticate with an API key (issued out of band) presented as a Bearer token.","scopes":["read"],"session":{"endpoint":"https://play.bizqiz.com/api/v1/agent/session","method":"POST","description":"Exchange an API key for a short-lived session token bound to a dedicated agent player.","tokenTtlSeconds":3600}},"capabilities":{"intentEndpoints":[{"method":"POST","path":"/api/v1/intents/find-game","description":"State what you want (\"a game live now\", \"anything starting soon\") and get back matching games — no need to page through the catalog yourself.","auth":"none","body":{"when":{"type":"string","enum":["now","soon","anytime"],"required":false},"eventType":{"type":"string","enum":["realtime","anytime"],"required":false},"q":{"type":"string","required":false},"limit":{"type":"integer","minimum":1,"maximum":50,"required":false}},"response":"200 { games: [...], reason: string } — always 200, even with an empty result."},{"method":"POST","path":"/api/v1/intents/get-join-link","description":"Resolve a game by id, short id, or a name fragment straight to its join link.","auth":"none","body":{"game":{"type":"string","description":"UUID id, short id, or a name fragment.","required":true}},"response":"200 { game, joinUrl, status } | 300 { error, candidates } when a name fragment is ambiguous | 404 { error } | 400 { error }."}],"sessions":{"endpoint":"https://play.bizqiz.com/api/v1/agent/session","method":"POST","description":"Exchange an API key for a short-lived session JWT bound to a dedicated agent player.","tokenTtlSeconds":3600},"scopedTokens":{"tokenEndpoint":"https://play.bizqiz.com/api/v1/agent/session","scopes":["read","play"],"description":"'read' grants access to the public game catalog; 'play' additionally allows joining and playing games as the agent's own player."},"auditLog":{"header":"X-Request-Id","description":"Responses carry this correlation header, and agent-authenticated requests are recorded."}}}