Skip to main content
POST
/
v1
/
dashboards
/
{dashboardId}
/
widgets
/
create
Create an org widget (convenience)
curl --request POST \
  --url https://public-api.sessionboard.com/v1/dashboards/{dashboardId}/widgets/create \
  --header 'Content-Type: application/json' \
  --header 'x-access-token: <api-key>' \
  --data '
{
  "type": "<string>",
  "title": "<string>",
  "config": {},
  "query": "<string>"
}
'

Authorizations

​
x-access-token
string
header
required

Organization API token. Generate from Organization Settings → API Tokens.

Path Parameters

​
dashboardId
string
required

Body

application/json
​
type
string
required

Widget type (e.g., chart, table, number).

​
title
string
​
config
object
​
query
string

SbQL query for the widget data.

Response

Widget created