> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.sessionboard.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Reports & Dashboards

> API access to Sessionboard Reports, Dashboards, and SbQL queries

> [!NOTE]
>
> **Early Access** — Reports, Dashboards, and related query APIs are currently available to select organizations. Reach out to your Sessionboard account manager to get early access.

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](https://apidocs.sessionboard.com/insights/mcp-server.md).

> [!NOTE]
>
> API tokens need the **`read:insights`** scope (the scope name is historical; it gates Reports, Dashboards, and SbQL access). See [Authentication](https://apidocs.sessionboard.com/authentication.md).

## Prerequisites

1. **Organization-level:** AI features must be enabled for your organization. Contact your Sessionboard account manager.
2. **Who is calling:** An assistant signed in with OAuth needs the **Connect AI assistants** permission. A script using an API token needs **`read:insights`** in its scopes (a token with no scopes is the legacy full-access case). There is no separate MCP switch.

## 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

> **[SbQL Reference](https://apidocs.sessionboard.com/insights/sbql.md)**
>
> Query language syntax, entities, and examples.

> **[MCP Server](https://apidocs.sessionboard.com/insights/mcp-server.md)**
>
> Connect Claude and other AI assistants to your event data.

> **[Connect an AI assistant](https://learn.sessionboard.com/integrations/connect-ai-assistants)**
>
> Step-by-step Help Center guides for Claude, ChatGPT, Copilot, and Gemini.

> **[Generate an API token](https://learn.sessionboard.com/integrations/api-tokens)**
>
> Help Center walkthrough of token scopes and PII Obfuscation. Assistants sign in with OAuth.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.