Skip to main content
PATCH
/
api
/
v1
/
status-pages
/
{id}
Update status page
curl --request PATCH \
  --url https://app.larm.dev/api/v1/status-pages/{id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "slug": "<string>",
  "description": "<string>",
  "theme": "<string>",
  "primary_color": "<string>",
  "enabled": true,
  "subscribers_enabled": true,
  "components": [
    {}
  ]
}
'
{
  "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": [
      {
        "id": "770e8400-e29b-41d4-a716-446655440000",
        "monitor_id": "550e8400-e29b-41d4-a716-446655440000",
        "display_name": "Website",
        "position": 0
      }
    ],
    "inserted_at": "2025-03-01T12:00:00Z",
    "updated_at": "2025-03-01T14:30:00Z"
  }
}

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.

Requires status_pages:read_write permission. Only include the fields you want to change.
​
id
string
required
Status page ID (UUID)
​
name
string
Page name (1–255 characters)
​
slug
string
URL identifier (3–63 characters, lowercase alphanumeric and hyphens)
​
description
string
Brief description (up to 1000 characters)
​
theme
string
system, light, or dark
​
primary_color
string
Brand color in hex format (e.g. #4F46E5)
​
enabled
boolean
Whether the page is publicly visible
​
subscribers_enabled
boolean
Allow email subscriptions
​
components
object[]
Replace the monitors displayed on the page. This is a full replacement — pass all components you want. Each object has monitor_id (UUID, required), display_name (string, required), and position (integer, required).
{
  "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": [
      {
        "id": "770e8400-e29b-41d4-a716-446655440000",
        "monitor_id": "550e8400-e29b-41d4-a716-446655440000",
        "display_name": "Website",
        "position": 0
      }
    ],
    "inserted_at": "2025-03-01T12:00:00Z",
    "updated_at": "2025-03-01T14:30:00Z"
  }
}