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, each distinct. Absent = shared with the creator's own role; explicit [] = private.

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