# Update dashboard content

Replace the content module configuration for a dashboard.

Source: https://statusdashboard.com/docs/api/status-dashboards/dashboards/content/update

`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](/docs/api) 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](#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
```bash
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`**

```json
{
  "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.                                        |