---
title: "Update a status page's name, slug, brand chrome and custom domain (partial)"
method: PATCH
path: "/status-pages/{id}"
tags: ["Status Pages"]
---

# Update a status page's name, slug, brand chrome and custom domain (partial)

`PATCH /status-pages/{id}`

## Request

- Base URL: `https://realuptime.io/api/v1`
- URL: `https://realuptime.io/api/v1/status-pages/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `name` string
  - `slug` string
  - `pageTitle` string, nullable
  - `pageDescription` string, nullable
  - `logoUrl` string, nullable
  - `hideBranding` boolean
  - `accentColor` string, nullable
  - `homepageUrl` string, nullable
  - `supportUrl` string, nullable
  - `themePreset` 'signal' | 'midnight' | 'slate' | 'ocean' | 'plum' | 'graphite', nullable
  - `fontChoice` 'inter' | 'system' | 'space-grotesk', nullable
  - `locale` 'en-US' | 'en-GB' | 'de-DE' | 'fr-FR' | 'es-ES' | 'it-IT' | 'pt-BR' | 'nl-NL' | 'sv-SE' | 'ja-JP' | 'ko-KR' | 'zh-CN', nullable
  - `customDomain` string, nullable

## Response `200`

The updated page.

- object
  - `statusPage` object, required
    - `id` string, required
    - `account_id` string, required
    - `slug` string, required
    - `name` string, required
    - `custom_domain` string, nullable, required
    - `page_title` string, nullable, required
    - `page_description` string, nullable, required
    - `logo_url` string, nullable, required
    - `domain_status` 'none' | 'pending_dns' | 'issuing' | 'issued' | 'error', required
    - `domain_error` string, nullable, required
    - `vendor_components` object[], required
      - `id` string, required
      - `display_name` string, required
      - `source` string, required
      - `vendor_slug` string, required
      - `notify_subscribers` boolean, required
      - `outages_url` string, required
    - `hide_branding` boolean
    - `accent_color` string, nullable
    - `homepage_url` string, nullable
    - `support_url` string, nullable
    - `theme_preset` string, nullable
    - `font_choice` string, nullable
    - `locale` string, nullable
    - `public_url` string

## Other responses

- `400`: Malformed body, a field the endpoint does not accept, a reserved slug, a non-https link, an unreadable accent color, an unknown theme/font/locale, or a customDomain that is not a public hostname. - `RU-5008` Invalid status page request: https://realuptime.io/kb/errors/ru-5008
- `401`: Missing, invalid, or revoked API key. - `RU-1001` Missing API credentials: https://realuptime.io/kb/errors/ru-1001 - `RU-1002` Invalid or revoked API key: https://realuptime.io/kb/errors/ru-1002
- `403`: customDomain needs a Growth or Scale plan. This key is read-only, or this key is IP-restricted and the request came from outside its allowlist. - `RU-2010` Custom domains need a paid plan: https://realuptime.io/kb/errors/ru-2010 - `RU-1004` API key is read-only: https://realuptime.io/kb/errors/ru-1004 - `RU-1007` API key is restricted to an IP allowlist: https://realuptime.io/kb/errors/ru-1007
- `404`: No such status page on this account. - `RU-5009` Status page or component not found: https://realuptime.io/kb/errors/ru-5009
- `409`: The new slug is already taken, or the customDomain is already attached to another page or the page already serves a different domain. - `RU-5010` Status page slug already taken: https://realuptime.io/kb/errors/ru-5010 - `RU-5015` Custom domain conflict: https://realuptime.io/kb/errors/ru-5015
- `429`: Per-key rate limit exceeded, a Free account's per-account request budget exceeded, or too many failed authentication attempts. - `RU-2003` API write rate limit exceeded: https://realuptime.io/kb/errors/ru-2003 - `RU-2001` Too many failed authentication attempts: https://realuptime.io/kb/errors/ru-2001
- `502`: The custom domain was recorded but its certificate could not be registered. - `RU-5016` Certificate provider unavailable: https://realuptime.io/kb/errors/ru-5016

---

[API](https://skmtc.dev/realuptime/apis/realuptime-api-v1.md) · [All operations](https://skmtc.dev/realuptime/apis/realuptime-api-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/realuptime/apis/realuptime-api-v1/revisions/51e481084700?raw)