Sign in
latestOpenAPI 3.1.0Apache License Version 2.02026-08-17498525913.3 KB

40169ccdec5c

dashboard-controller

Create Or Update Dashboard (saveDashboard)

Create or update the Dashboard. When creating dashboard, platform generates Dashboard Id as time-based UUID. 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.

post/api/dashboard

Headers

Accept-Encodingstring

Request body

titlestring required

Title of the dashboard.

imagestring

Thumbnail picture for rendering of the dashboards in a grid view on mobile devices.

mobileHideboolean

Hide dashboard from mobile devices. Useful if the dashboard is not designed for small screens.

mobileOrderinteger

Order on mobile devices. Useful to adjust sorting of the dashboards for mobile applications

{"stackTrail":"components:schemas:JsonNode","oasType":"schema","type":"unknown","description":"A value representing the any type (object or primitive)","example":{}}
namestring

Same as title of the dashboard. Read-only field. Update the 'title' to change the 'name' of the dashboard.

createdTimeinteger

Timestamp of the dashboard creation, in milliseconds

versioninteger

Example request

{
  "configuration": {},
  "id": {
    "id": "784f394c-42b6-435a-983c-b7beff2784f9",
    "entityType": "DASHBOARD"
  },
  "createdTime": 1609459200000,
  "tenantId": {
    "id": "784f394c-42b6-435a-983c-b7beff2784f9",
    "entityType": "TENANT"
  },
  "assignedCustomers": [
    {
      "customerId": {
        "id": "784f394c-42b6-435a-983c-b7beff2784f9",
        "entityType": "CUSTOMER"
      }
    }
  ]
}

Response

OK