Update branding configuration for a status page.

PUT

/status_page/{status_page_id}/branding

curl --request PUT \
  --url https://api.siteqwality.com/status_page/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/branding \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "page_title": "example", "default_theme": "example", "logo_s3_key": "example", "logo_dark_s3_key": "example", "favicon_s3_key": "example", "og_image_s3_key": "example", "primary_color": "example", "accent_color": "example", "header_text": "example", "footer_text": "example", "white_label": true, "meta_description": "example", "custom_css": "example" }'

• Production

A field left out keeps its value and null clears it. Saving publishes the page again (the status page publish layer runs on every write here). Every field, badge removal included, is free on every plan (BD1 A).

Authorizations

• bearer_auth

Parameters

Path Parameters

status_page_id

required

string format: uuid

Status page identifier

Request Body ^required

Media type application/json

A field left out keeps its value and null clears it: default_theme goes back to system, white_label to false, and every other field to unset. An empty or blank text field clears it too.

object

page_title

At most 100 characters.

string | null

default_theme

light, dark or system.

string | null

logo_s3_key

The s3_key an upload of type logo returned.

string | null

logo_dark_s3_key

The s3_key an upload of type logo_dark returned: the logo the page shows in its dark theme. Without it the page shows the logo in both.

string | null

favicon_s3_key

string | null

og_image_s3_key

string | null

primary_color

#rrggbb. Colors the page title (without a logo) and headings.

string | null

accent_color

#rrggbb. Colors the subscribe button, links, focus ring and chart line; falls back to primary_color. The page adjusts both colors per theme where needed to keep text and controls readable.

string | null

header_text

At most 500 characters.

string | null

footer_text

At most 500 characters.

string | null

white_label

Hides the “Powered by Site Qwality” badge. true needs the White-Label pack.

boolean | null

meta_description

At most 160 characters.

string | null

custom_css

At most 50 KB.

string | null

Example ^generated

{
  "page_title": "example",
  "default_theme": "example",
  "logo_s3_key": "example",
  "logo_dark_s3_key": "example",
  "favicon_s3_key": "example",
  "og_image_s3_key": "example",
  "primary_color": "example",
  "accent_color": "example",
  "header_text": "example",
  "footer_text": "example",
  "white_label": true,
  "meta_description": "example",
  "custom_css": "example"
}

Responses

200

Branding updated

Media type application/json

object

status_page_id

required

string

page_title

string | null

default_theme

required

string

logo_s3_key

string | null

logo_dark_s3_key

string | null

favicon_s3_key

string | null

og_image_s3_key

string | null

logo_url

CDN URLs of the assets above, for previews.

string | null

logo_dark_url

string | null

favicon_url

string | null

og_image_url

string | null

primary_color

string | null

accent_color

string | null

header_text

string | null

footer_text

string | null

white_label

required

boolean

meta_description

string | null

custom_css

string | null

Example ^generated

{
  "status_page_id": "example",
  "page_title": "example",
  "default_theme": "example",
  "logo_s3_key": "example",
  "logo_dark_s3_key": "example",
  "favicon_s3_key": "example",
  "og_image_s3_key": "example",
  "logo_url": "example",
  "logo_dark_url": "example",
  "favicon_url": "example",
  "og_image_url": "example",
  "primary_color": "example",
  "accent_color": "example",
  "header_text": "example",
  "footer_text": "example",
  "white_label": true,
  "meta_description": "example",
  "custom_css": "example"
}

400

Invalid request body

401

Missing or invalid authentication

404

Status page not found

500

Internal server error