---
title: "Create Or Update Dashboard (saveDashboard)"
method: POST
path: "/api/dashboard"
tags: ["dashboard-controller"]
---

# Create Or Update Dashboard (saveDashboard)

`POST /api/dashboard`

Create or update the Dashboard. When creating dashboard, platform generates Dashboard Id as [time-based UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier#Version_1_(date-time_and_MAC_address)). The newly created Dashboard id will be present in the response. Specify existing Dashboard id to update the dashboard. Referencing non-existing dashboard Id will cause 'Not Found' error. Remove 'id', 'tenantId' and optionally 'customerId' from the request body example (below) to create new Dashboard entity. 

Available for users with 'TENANT_ADMIN' authority.

## Headers

- `Accept-Encoding` string

## Request body

- Dashboard
  - `title` string, required — Title of the dashboard.
  - `image` string — Thumbnail picture for rendering of the dashboards in a grid view on mobile devices.
  - `mobileHide` boolean — Hide dashboard from mobile devices. Useful if the dashboard is not designed for small screens.
  - `mobileOrder` integer — Order on mobile devices. Useful to adjust sorting of the dashboards for mobile applications
  - `configuration` unknown
  - `name` string — Same as title of the dashboard. Read-only field. Update the 'title' to change the 'name' of the dashboard.
  - `resources` ResourceExportData[]
    - `link` string
    - `title` string
    - `type` 'LWM2M_MODEL' | 'JKS' | 'PKCS_12' | 'JS_MODULE' | 'IMAGE' | 'DASHBOARD' | 'GENERAL'
    - `subType` 'IMAGE' | 'SCADA_SYMBOL' | 'EXTENSION' | 'MODULE'
    - `resourceKey` string
    - `fileName` string
    - `publicResourceKey` string
    - `isPublic` boolean
    - `mediaType` string
    - `data` string
    - `public` boolean
  - `id` DashboardId
    - `id` string, uuid, required — ID of the entity, time-based UUID v1
    - `entityType` 'DASHBOARD', required — string
  - `createdTime` integer — Timestamp of the dashboard creation, in milliseconds
  - `tenantId` TenantId
    - `id` string, uuid, required — ID of the entity, time-based UUID v1
    - `entityType` 'TENANT', required — string
  - `assignedCustomers` ShortCustomerInfo[] — List of assigned customers with their info.
    - `customerId` CustomerId
      - `id` string, uuid, required — ID of the entity, time-based UUID v1
      - `entityType` 'CUSTOMER', required — string
    - `title` string — Title of the customer.
    - `isPublic` boolean
    - `public` boolean
  - `version` integer

## Response `200`

OK

---

[API](https://skmtc.net/thingsboard/apis/thingsboard-rest-api.md) · [All operations](https://skmtc.net/thingsboard/apis/thingsboard-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/thingsboard/thingsboard-rest-api/revisions/40169ccdec5c/schema)