Skip to main content

Create dashboard

POST /v2/dashboard/

Creates a new dashboard for the authenticated tenant. This endpoint initializes a dashboard with basic metadata such as name, role context, status, and an optional list of sections. It returns the created dashboard object with identifiers and timestamps for auditing.

Request Body​

{
    "name": "John",
    "role": "admin"
  }

Response Example​

{
  "name": "Example Dashboard",
  "role": "admin",
  "roleDisplay": "Administrator",
  "tenant": "tenant-id-1",
  "status": "inactive",
  "sections": [],
  "_id": "dashboard-id-1",
  "created": "2025-10-29T13:53:56.110Z",
  "updated": "2025-10-29T13:53:56.110Z"
}