Update dashboard

PUT 

/v2/illuminate/dashboards/:id

Updates an existing dashboard. Same request body as create.

Warning: The charts array is a full replacement. Omitting a chart from the array deletes it. To keep existing charts, include them with their charts[].id.

Field behavior on PUT

FieldBehavior
nameReplaced
dateRangeReplaced
startDate / endDateRequired when dateRange is "Custom date"
chartsFull replacement — include id for existing charts
customerIdCannot be changed after creation

Common errors

StatusCause
400Missing charts[].id for an existing chart (creates duplicate instead of updating)
404Dashboard ID does not exist

Request

Example
{
  "createdAt": "2024-01-01T00:00:00.000Z",
  "updatedAt": "2024-01-01T00:00:00.000Z",
  "createdBy": "string",
  "updatedBy": "string",
  "id": "string",
  "name": "string",
  "accountId": "string",
  "dateRange": "30 minutes",
  "startDate": "2024-01-01T00:00:00.000Z",
  "endDate": "2024-01-01T00:00:00.000Z",
  "charts": [
    {
      "id": "access_manager_by_metric",
      "series": [
        {}
      ]
    }
  ],
  "customer": {
    "id": "string",
    "name": "string"
  }
}