> ## Documentation Index
> Fetch the complete documentation index at: https://docs.larm.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Update status page

> Updates an existing status page

Requires `status_pages:read_write` permission. Only include the fields you want to change.

Updates only the page's own fields. To modify components and groups, use the dedicated CRUD endpoints or replace the entire structure with [PUT structure](/api-reference/status-pages/structure). To attach a custom domain, use the custom-domain endpoint (separate from this one).

<ParamField path="id" type="string" required>
  Status page ID (UUID)
</ParamField>

<ParamField body="name" type="string">
  Page name (1–255 characters)
</ParamField>

<ParamField body="slug" type="string">
  URL identifier (3–63 characters, lowercase alphanumeric and hyphens; cannot start or end with a hyphen)
</ParamField>

<ParamField body="description" type="string">
  Brief description (up to 1000 characters)
</ParamField>

<ParamField body="theme" type="string">
  `system`, `light`, or `dark`
</ParamField>

<ParamField body="primary_color" type="string">
  Brand color in hex format (e.g. `#4F46E5`)
</ParamField>

<ParamField body="logo_light_url" type="string">
  URL of the logo to use on light backgrounds
</ParamField>

<ParamField body="logo_dark_url" type="string">
  URL of the logo to use on dark backgrounds
</ParamField>

<ParamField body="show_theme_switcher" type="boolean">
  Show a light/dark theme switcher on the public page
</ParamField>

<ParamField body="enabled" type="boolean">
  Whether the page is publicly visible
</ParamField>

<ParamField body="subscribers_enabled" type="boolean">
  Allow email subscriptions
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Acme Status",
      "slug": "acme",
      "description": "Current status of Acme services",
      "theme": "dark",
      "primary_color": "#4F46E5",
      "enabled": true,
      "subscribers_enabled": true,
      "custom_domain": null,
      "domain_status": "none",
      "logo_light_url": null,
      "logo_dark_url": null,
      "url": "https://acme.status.larm.dev",
      "components": [],
      "inserted_at": "2025-03-01T12:00:00Z",
      "updated_at": "2025-03-01T14:30:00Z"
    }
  }
  ```
</ResponseExample>