Skip to content
SessionboardSessionboardSessionboard Help Center

Run a saved report

Build the report once in Sessionboard, then run it on a schedule from your own system. You need a token with read:insights.

1. Find the report

Section titled “1. Find the report”

GET /v1/event/{eventId}/insights/queries lists an event’s saved reports, and GET /v1/insights/queries the organization’s. Note the report’s id.

2. Run it

Section titled “2. Run it”
Terminal window
curl --request POST \
  --url 'https://public-api.sessionboard.com/v1/event/{eventId}/insights/queries/{queryId}/run' \
  --header 'x-access-token: <api-token>'

POST /v1/event/{eventId}/insights/queries/{queryId}/run runs it on that event; POST /v1/insights/queries/{queryId}/run runs an organization report. The report’s columns and filters are the ones saved in Sessionboard, so changing the report there changes what your script gets.

To write a query yourself instead, see the SbQL Reference.

Get release notes by email

A short digest on the days something new goes live — each change with a link to its note in the release notes. No marketing, and one click to stop.

Company email addresses only. We’ll send one email to confirm it’s you. Already use Sessionboard? You can also turn this on under Community → What’s new.