---
title: "Update a status page"
method: PATCH
path: "/v1/status-pages/{id}"
tags: ["Status pages"]
---

# Update a status page

`PATCH /v1/status-pages/{id}`

## Request

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

Update mutable fields of a status page (title, slug, public visibility, uptime display). Requires a `write`-scoped key.

## Path parameters

- `id` string, uuid, required

## Request body

- StatusPageUpdate: Request body for updating a status page (all fields optional; TD-943).
  - `title` string
  - `slug` string
  - `is_public` boolean
  - `show_uptime` boolean
  - `list_in_public_directory` boolean

## Response `200`

The updated status page.

- StatusPage
  - `id` string, uuid, required
  - `tenant_id` string, uuid, required
  - `client_id` string, uuid, required
  - `slug` string, required
  - `title` string, required
  - `is_public` boolean, required
  - `show_uptime` boolean, required
  - `list_in_public_directory` boolean, required
  - `custom_domain` string, nullable, required
  - `display_timezone` string, nullable, required
  - `component_count` integer, required
  - `public_url` string, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `400`: Error — canonical envelope with a trace_id.
- `401`: Error — canonical envelope with a trace_id.
- `403`: Error — canonical envelope with a trace_id.
- `404`: Error — canonical envelope with a trace_id.
- `409`: Error — canonical envelope with a trace_id.
- `429`: Error — canonical envelope with a trace_id.

---

[API](https://skmtc.dev/merlonix/apis/merlonix-public-api.md) · [All operations](https://skmtc.dev/merlonix/apis/merlonix-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/merlonix/apis/merlonix-public-api/revisions/2192584bdfcd?raw)