Skip to main content
POST
Create dashboard

Authorizations

Authorization
string
header
required

Use a valid Bearer token to authenticate.

Body

application/json

Dashboard to create

name
string
required
Maximum string length: 200
description
string
templateId
string

Template name (for example dailyOperations), not its _id. Names are stable across environments; ObjectIds are not.

Maximum string length: 200
sharedRoleIds
string[]

Role ids of the caller's organization, each distinct, at least one. Absent = shared with the creator's own role. An empty array is 400 dydsh-009, a repeated id is 400 dydsh-002, and a role of another organization or an unknown id is 400 dydsh-011 ("Share the dashboard with at least one role of your organization.").

Maximum array length: 50
hubScope
object
timeRange
object

Default time window for the dashboard, or null. Not interpreted by the CRUD layer; the analytics endpoint accepts today, yesterday, last_7d, last_30d.

grid
object
widgets
object[]

Response

Created - the new dashboard, with widget definitions attached

status
boolean
Example:

true

code
integer
message
string
data
object