Reports & Dashboards
These endpoints power Reports and Dashboards in Sessionboard — the same surfaces organizers use in the product to explore session and speaker data, run saved reports, and view dashboard widgets.
Under the hood, queries use SbQL (Sessionboard Query Language). You can also convert natural language into SbQL, discover the query schema, and connect AI assistants via the MCP Server.
Prerequisites
Section titled “Prerequisites”- Organization-level: AI features must be enabled for your organization. Contact your Sessionboard account manager.
- Who is calling: An assistant signed in with OAuth needs the Connect AI assistants permission. A script using an API token needs
read:insightsin its scopes (a token with no scopes is the legacy full-access case). There is no separate MCP switch.
What this covers
Section titled “What this covers”| Capability | Product mapping | Description |
|---|---|---|
| Saved reports | Reports | List and run saved queries created in Sessionboard |
| Dashboards | Dashboards | Retrieve dashboard configs and widget data |
| Execute SbQL | Reports / ad-hoc analysis | Run SbQL against your event data |
| Generate SbQL | AI assist | Turn natural language into SbQL |
| Schema discovery | Query builder | Entities, fields, and relationships you can query |
| Suggestions | Query assist | Contextual query suggestions |
Endpoint paths still use the /v1/insights/... prefix (for example POST /v1/insights/execute, GET /v1/insights/queries). That prefix is the public API namespace — not a separate product called Insights.
Learn more
Section titled “Learn more”SbQL Reference
Query language syntax, entities, and examples.
MCP Server
Connect Claude and other AI assistants to your event data.
Connect an AI assistant
Step-by-step Help Center guides for Claude, ChatGPT, Copilot, and Gemini.
Generate an API token
Help Center walkthrough of token scopes and event restrictions. Assistants sign in with OAuth.