Update dashboard content — StatusDashboard Docs

PUT /app/dashboards/{id}/content

Replaces the content module toggles, display order, and uptime history configuration for a dashboard. This is a full replacement.

Path parameters

Parameter	Description
`id`	The UUID of the dashboard.

Request

See API Basics for required headers.

Request body

Field	Type	Required	Description
`activeIncidents`	boolean	Yes	Show the active incidents section on the status dashboard.
`activeMaintenance`	boolean	Yes	Show active maintenance windows on the status dashboard.
`eventHistory`	boolean	Yes	Show the event history section.
`scheduledMaintenance`	boolean	Yes	Show upcoming scheduled maintenance windows.
`informational`	boolean	Yes	Show the informational notices section.
`weeklyActivity`	boolean	Yes	Show the weekly activity chart.
`moduleOrder`	array of strings	Yes	Display order of content modules. Must contain each module key. See module keys below.
`uptimeHistory`	object	Yes	Uptime history bar chart configuration.
`timestampFormat`	string	Yes	How event timestamps are displayed on the status dashboard. One of `relative` or `exact`.

`uptimeHistory` object

Field	Type	Description
`enabled`	boolean	Show the uptime history section.
`days`	integer	Number of days to display. One of `1`–`7`.

Module keys

The moduleOrder array controls the vertical order of sections on the status dashboard. It must contain all of the following values:

Value	Description	Order
`activeIncidents`	Active incidents section.	Most recently started first.
`activeMaintenance`	Active maintenance windows section.	Most recently started first.
`scheduledMaintenance`	Upcoming scheduled maintenance section.	Soonest upcoming first.
`informational`	Informational notices and announcements section.	Most recently posted first.
`weeklyActivity`	Weekly activity chart.	Fixed 7-day window with week navigation.
`eventHistory`	Historical closed events section.	Most recently resolved first.
`components`	Component status grid.	—

Sample request

curl -X PUT https://api.statusdashboard.com/app/dashboards/a1b2c3d4-e5f6-7890-abcd-ef1234567890/content \
  -H "Authorization: Bearer bcf847abf5c6:def456" \
  -H "Content-Type: application/json" \
  -d '{
    "activeIncidents": true,
    "activeMaintenance": true,
    "eventHistory": true,
    "scheduledMaintenance": false,
    "informational": true,
    "weeklyActivity": true,
    "moduleOrder": [
      "activeIncidents",
      "activeMaintenance",
      "scheduledMaintenance",
      "informational",
      "weeklyActivity",
      "components",
      "eventHistory"
    ],
    "uptimeHistory": {
      "enabled": true,
      "days": 7
    },
    "timestampFormat": "exact"
  }'

Sample response

Status: 200 OK

{
  "activeIncidents": true,
  "activeMaintenance": true,
  "eventHistory": true,
  "scheduledMaintenance": false,
  "informational": true,
  "moduleOrder": [
    "activeIncidents",
    "activeMaintenance",
    "scheduledMaintenance",
    "informational",
    "components",
    "eventHistory"
  ],
  "uptimeHistory": {
    "enabled": true,
    "days": 7
  },
  "timestampFormat": "exact"
}

Error responses

Status	When
`400`	Validation failure — invalid or incomplete `moduleOrder`, invalid `days` value, or missing required fields.
`403`	Insufficient permissions.
`404`	Dashboard not found or does not belong to the caller's organization.

On this page