Update Status Page Design

PATCH /api/status-pages/:id/design

Updates the visual design configuration of a status page. Only the fields you provide are changed — all other settings keep their current values. Requires admin role.

Path Parameter

Parameter	Description
`id`	Status page ID or `publicId` (UUID)

Request Body (all optional)

Layout

Field	Type	Values	Default	Description
`layout`	string	`classic` `cards` `minimal` `sleek` `board` `split` `timeline` `compact`	`classic`	Visual layout template
`pageWidth`	string	`sm` `md` `lg` `xl`	`lg`	Max content width: sm = 672 px, md = 896 px, lg = 1024 px, xl = 1280 px

Colors

Field	Type	Values	Default	Description
`colorScheme`	string	`light` `dark` `auto`	`auto`	Color mode. `auto` follows the visitor's system preference.
`accentColor`	string	hex, e.g. `#6366f1`	`#6366f1`	Brand accent color used for highlights, borders, and gradients

Typography & Style

Field	Type	Values	Default	Description
`fontFamily`	string	`system` `mono`	`system`	`system` = default sans-serif, `mono` = monospace
`cardRadius`	string	`none` `md` `xl`	`md`	Card corner radius: none = sharp, md = rounded, xl = pill

Header

Field	Type	Values	Default	Description
`headerStyle`	string	`simple` `centered` `hero`	`simple`	`simple` = left-aligned, `centered` = centered, `hero` = full gradient banner
`customTitle`	string	max 120 chars	`""`	Overrides the status page name in the header. Leave empty to use the page name.
`customSubtitle`	string	max 200 chars	`""`	Optional tagline below the title

Display options

Field	Type	Default	Description
`showUptimeStats`	boolean	`true`	Show uptime percentage and service counts
`showServiceUrls`	boolean	`false`	Show the monitored URL below each service name
`showLastChecked`	boolean	`false`	Show the last check timestamp per service
`showHistory`	boolean	`true`	Show the recent incidents & maintenance section
`showPoweredBy`	boolean	`true`	Show "Powered by …" badge in the footer

Example — switch to dark timeline layout

curl -X PATCH "$BASE_URL/api/status-pages/db58058e-4b58-4d97-a314-3bb8e279a182/design" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "layout": "timeline",
    "colorScheme": "dark",
    "accentColor": "#f59e0b",
    "pageWidth": "lg"
  }'

Example — minimal, no branding, full width

curl -X PATCH "$BASE_URL/api/status-pages/db58058e-4b58-4d97-a314-3bb8e279a182/design" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "layout": "minimal",
    "colorScheme": "light",
    "pageWidth": "xl",
    "showPoweredBy": false,
    "showUptimeStats": false,
    "customTitle": "System Status",
    "customSubtitle": "Live overview of all services"
  }'

Response

{
  "designConfig": {
    "layout": "timeline",
    "colorScheme": "dark",
    "accentColor": "#f59e0b",
    "headerStyle": "simple",
    "fontFamily": "system",
    "cardRadius": "md",
    "pageWidth": "lg",
    "customTitle": "",
    "customSubtitle": "",
    "showPoweredBy": true,
    "showUptimeStats": true,
    "showServiceUrls": false,
    "showLastChecked": false,
    "showHistory": true
  }
}

Common errors

400 Bad Request — invalid field value (e.g. unknown layout name or malformed hex color)
401 Unauthorized — not authenticated
403 Forbidden — not an admin
404 Not found — status page does not exist