Phare

Update a status page

update_status_page

DestructiveIdempotent

Update a status page by ID, the fields left out keep their current value. A components list replaces the current components, and a new domain replaces its custom domain certificate, issued automatically once the domain has a CNAME record pointing to cname.status.phare.io. Logos and favicons can only be uploaded with a multipart/form-data request.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "project_id": "<project_id>",
      "status_page_id": "<status_page_id>"
    },
    "name": "update_status_page"
  }
}

Input Schema

Name	Required	Description	Default
`name`	No	Status page name
`tags`	No	Resource tags, made of lowercase letters, numbers, `.`, `_`, `:` and `-`. An organization can have up to 200 tags.
`theme`	No	Theme settings to customize the status page
`title`	No	Status page HTML title
`domain`	No	Custom domain name for the status page
`timezone`	No	Timezone used to split the status page timeline into days and to display all dates on the status page and in feeds. Must be a canonical IANA timezone identifier (case-sensitive, e.g. `Europe/Paris`, `America/New_York` or `UTC`).	UTC
`logo_dark`	No	Dark theme logo of the status page (accepted formats: jpeg / png / svg, max size: 1MB). Files can only be uploaded with a `multipart/form-data` request, send `false` to remove the logo.
`subdomain`	No	Subdomain name for the status page, hosted on a phare.io domain: {subdomain}.status.phare.io
`timeframe`	No	Number of days of status and incident history to display.
`access_ips`	No	List of IP addresses or CIDR ranges allowed to access the status page. Requires an active Scale plan subscription.
`components`	No	List of components to show on the status page. A monitor can only be shown once on a status page.
`logo_light`	No	Light theme logo of the status page (accepted formats: jpeg / png / svg, max size: 1MB). Files can only be uploaded with a `multipart/form-data` request, send `false` to remove the logo.
`project_id`	Yes	ID of the project to act on, see whoami
`description`	No	Status page HTML description
`website_url`	No	URL to redirect users clicking the status page logo
`access_token`	No	Token to restrict access to the status page. Requires an active Scale plan subscription.
`color_scheme`	No	Choose the available color schemes for the status page	all
`favicon_dark`	No	Dark theme favicon of the status page (accepted formats: jpeg / png / svg, max size: 1MB, square image). Files can only be uploaded with a `multipart/form-data` request, send `false` to remove the favicon.
`favicon_light`	No	Light theme favicon of the status page (accepted formats: jpeg / png / svg, max size: 1MB, square image). Files can only be uploaded with a `multipart/form-data` request, send `false` to remove the favicon.
`status_page_id`	Yes	ID of the status page to update
`access_password`	No	Password to restrict access to the status page. Requires an active Scale plan subscription.
`show_response_times`	No	Whether to display response times for monitors on the status page
`search_engine_indexed`	No	Whether search engines are allowed to index the page
`subscription_channels`	No	List of active subscription channels

Output Schema

Name	Required	Description	Default
`id`	No	Status page ID
`name`	No	Status page name
`tags`	No	Resource tags, made of lowercase letters, numbers, `.`, `_`, `:` and `-`. An organization can have up to 200 tags.
`theme`	No	Theme settings to customize the status page
`title`	No	Status page HTML title
`domain`	No	Custom domain name for the status page
`timezone`	No	Timezone used to split the status page timeline into days and to display all dates on the status page and in feeds. Must be a canonical IANA timezone identifier (case-sensitive, e.g. `Europe/Paris`, `America/New_York` or `UTC`).	UTC
`subdomain`	No	Subdomain name for the status page, hosted on a phare.io domain: {subdomain}.status.phare.io
`timeframe`	No	Number of days of status and incident history to display.
`access_ips`	No	List of IP addresses or CIDR ranges allowed to access the status page. Requires an active Scale plan subscription.
`components`	No	List of components to show on the status page. A monitor can only be shown once on a status page.
`created_at`	No	Date of creation for the entity
`is_private`	No	Whether access to the status page is restricted by a password, a secret token or an IP allowlist
`project_id`	No	Parent project ID
`updated_at`	No	Date of last update for the entity
`description`	No	Status page HTML description
`website_url`	No	URL to redirect users clicking the status page logo
`color_scheme`	No	Choose the available color schemes for the status page	all
`show_response_times`	No	Whether to display response times for monitors on the status page
`access_token_enabled`	No	Whether the status page is protected by a secret token. Requires an active Scale plan subscription.
`search_engine_indexed`	No	Whether search engines are allowed to index the page
`subscription_channels`	No	List of active subscription channels
`access_password_enabled`	No	Whether the status page is protected by a password. Requires an active Scale plan subscription.

Schema Changelog

Changes observed during successful MCP inspections.

Changed26 schema fields changedNov 7, 2026

changedInput schema / properties / components / items / oneOf

Previous value: -[
-  {
-    "properties": {
-      "componentable_id": {
-        "description": "ID of the monitor to show",
-        "type": "integer"
-      },
-      "componentable_type": {
-        "enum": [
-          "uptime/monitor"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "componentable_type",
-      "componentable_id"
-    ],
-    "title": "Monitor component",
-    "type": "object"
-  },
-  {
-    "properties": {
-      "componentable_type": {
-        "enum": [
-          "uptime/group"
-        ],
-        "type": "string"
-      },
-      "components": {
-        "description": "List of monitor components shown inside the group",
-        "items": {
-          "properties": {
-            "componentable_id": {
-              "description": "ID of the monitor to show",
-              "type": "integer"
-            },
-            "componentable_type": {
-              "enum": [
-                "uptime/monitor"
-              ],
-              "type": "string"
-            }
-          },
-          "required": [
-            "componentable_type",
-            "componentable_id"
-          ],
-          "type": "object"
-        },
-        "maxItems": 100,
-        "minItems": 1,
-        "type": "array"
-      },
-      "is_expanded": {
-        "default": false,
-        "description": "Whether the group components are expanded by default",
-        "examples": [
-          false
-        ],
-        "type": "boolean"
-      },
-      "name": {
-        "description": "Name of the group shown on the status page. Must be unique within the status page (case-insensitive).",
-        "maxLength": 100,
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "componentable_type",
-      "name",
-      "components"
-    ],
-    "title": "Group component",
-    "type": "object"
-  }
-]New value: +[
+  {
+    "properties": {
+      "componentable_id": {
+        "description": "ID of the monitor to show",
+        "type": "integer"
+      },
+      "componentable_type": {
+        "description": "Shows a monitor",
+        "enum": [
+          "uptime/monitor"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "componentable_type",
+      "componentable_id"
+    ],
+    "title": "Monitor component",
+    "type": "object"
+  },
+  {
+    "properties": {
+      "componentable_type": {
+        "description": "Shows a group of monitors",
+        "enum": [
+          "uptime/group"
+        ],
+        "type": "string"
+      },
+      "components": {
+        "description": "List of monitor components shown inside the group",
+        "items": {
+          "properties": {
+            "componentable_id": {
+              "description": "ID of the monitor to show",
+              "type": "integer"
+            },
+            "componentable_type": {
+              "description": "Shows a monitor",
+              "enum": [
+                "uptime/monitor"
+              ],
+              "type": "string"
+            }
+          },
+          "required": [
+            "componentable_type",
+            "componentable_id"
+          ],
+          "type": "object"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array"
+      },
+      "is_expanded": {
+        "default": false,
+        "description": "Whether the group components are expanded by default",
+        "examples": [
+          false
+        ],
+        "type": "boolean"
+      },
+      "name": {
+        "description": "Name of the group shown on the status page. Must be unique within the status page (case-insensitive).",
+        "maxLength": 100,
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "componentable_type",
+      "name",
+      "components"
+    ],
+    "title": "Group component",
+    "type": "object"
+  }
+]

addedInput schema / properties / theme / properties / border_width / description

Added value: +"Width of the borders, in pixels, from 2 the icons are drawn bolder too"

addedInput schema / properties / theme / properties / dark / properties / background / description
```
Added value: +"Page background color"
```
addedInput schema / properties / theme / properties / dark / properties / background_card / description
```
Added value: +"Background color of the cards"
```
addedInput schema / properties / theme / properties / dark / properties / border / description
```
Added value: +"Border color"
```

addedInput schema / properties / theme / properties / dark / properties / degraded_performance / description

Added value: +"Color of the degraded performance status, and of the timeline days with a degraded performance incident"

addedInput schema / properties / theme / properties / dark / properties / empty / description
```
Added value: +"Color of the timeline days without data, before the monitor was created"
```
addedInput schema / properties / theme / properties / dark / properties / foreground / description
```
Added value: +"Text color"
```
addedInput schema / properties / theme / properties / dark / properties / foreground_muted / description
```
Added value: +"Secondary text color"
```
addedInput schema / properties / theme / properties / dark / properties / maintenance / description
```
Added value: +"Color of the maintenance status, and of the timeline days with a maintenance"
```

addedInput schema / properties / theme / properties / dark / properties / major_outage / description

Added value: +"Color of the major outage status, and of the timeline days with a major outage incident"

addedInput schema / properties / theme / properties / dark / properties / operational / description
```
Added value: +"Color of the operational status, and of the timeline days without incident"
```

addedInput schema / properties / theme / properties / dark / properties / partial_outage / description

Added value: +"Color of the partial outage status, and of the timeline days with a partial outage incident"

addedInput schema / properties / theme / properties / light / properties / background / description
```
Added value: +"Page background color"
```
addedInput schema / properties / theme / properties / light / properties / background_card / description
```
Added value: +"Background color of the cards"
```
addedInput schema / properties / theme / properties / light / properties / border / description
```
Added value: +"Border color"
```

addedInput schema / properties / theme / properties / light / properties / degraded_performance / description

Added value: +"Color of the degraded performance status, and of the timeline days with a degraded performance incident"

addedInput schema / properties / theme / properties / light / properties / empty / description
```
Added value: +"Color of the timeline days without data, before the monitor was created"
```
addedInput schema / properties / theme / properties / light / properties / foreground / description
```
Added value: +"Text color"
```
addedInput schema / properties / theme / properties / light / properties / foreground_muted / description
```
Added value: +"Secondary text color"
```
addedInput schema / properties / theme / properties / light / properties / maintenance / description
```
Added value: +"Color of the maintenance status, and of the timeline days with a maintenance"
```

addedInput schema / properties / theme / properties / light / properties / major_outage / description

Added value: +"Color of the major outage status, and of the timeline days with a major outage incident"

addedInput schema / properties / theme / properties / light / properties / operational / description
```
Added value: +"Color of the operational status, and of the timeline days without incident"
```

addedInput schema / properties / theme / properties / light / properties / partial_outage / description

Added value: +"Color of the partial outage status, and of the timeline days with a partial outage incident"

addedInput schema / properties / theme / properties / rounded / description

Added value: +"Whether the corners of the page elements are rounded, square otherwise"

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "properties": {
+    "access_ips": {
+      "description": "List of IP addresses or CIDR ranges allowed to access the status page. Requires an active Scale plan subscription.",
+      "items": {
+        "examples": [
+          "45.129.56.0/24"
+        ],
+        "type": "string"
+      },
+      "type": [
+        "array",
+        "null"
+      ]
+    },
+    "access_password_enabled": {
+      "description": "Whether the status page is protected by a password. Requires an active Scale plan subscription.",
+      "examples": [
+        false
+      ],
+      "type": "boolean"
+    },
+    "access_token_enabled": {
+      "description": "Whether the status page is protected by a secret token. Requires an active Scale plan subscription.",
+      "examples": [
+        false
+      ],
+      "type": "boolean"
+    },
+    "color_scheme": {
+      "default": "all",
+      "description": "Choose the available color schemes for the status page",
+      "enum": [
+        "all",
+        "dark",
+        "light"
+      ],
+      "examples": [
+        "all"
+      ],
+      "type": "string"
+    },
+    "components": {
+      "description": "List of components to show on the status page. A monitor can only be shown once on a status page.",
+      "items": {
+        "anyOf": [
+          {
+            "properties": {
+              "componentable_id": {
+                "description": "ID of the monitor to show",
+                "type": "integer"
+              },
+              "componentable_type": {
+                "description": "Shows a monitor",
+                "enum": [
+                  "uptime/monitor"
+                ],
+                "type": "string"
+              }
+            },
+            "title": "Monitor component",
+            "type": "object"
+          },
+          {
+            "properties": {
+              "componentable_type": {
+                "description": "Shows a group of monitors",
+                "enum": [
+                  "uptime/group"
+                ],
+                "type": "string"
+              },
+              "components": {
+                "description": "List of monitor components shown inside the group",
+                "items": {
+                  "properties": {
+                    "componentable_id": {
+                      "description": "ID of the monitor to show",
+                      "type": "integer"
+                    },
+                    "componentable_type": {
+                      "description": "Shows a monitor",
+                      "enum": [
+                        "uptime/monitor"
+                      ],
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "is_expanded": {
+                "default": false,
+                "description": "Whether the group components are expanded by default",
+                "examples": [
+                  false
+                ],
+                "type": "boolean"
+              },
+              "name": {
+                "description": "Name of the group shown on the status page. Must be unique within the status page (case-insensitive).",
+                "type": "string"
+              }
+            },
+            "title": "Group component",
+            "type": "object"
+          }
+        ]
+      },
+      "type": "array"
+    },
+    "created_at": {
+      "description": "Date of creation for the entity",
+      "format": "date-time",
+      "type": "string"
+    },
+    "description": {
+      "description": "Status page HTML description",
+      "examples": [
+        "Status page of phare.io"
+      ],
+      "type": "string"
+    },
+    "domain": {
+      "description": "Custom domain name for the status page",
+      "examples": [
+        "status.example.com"
+      ],
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "id": {
+      "description": "Status page ID",
+      "examples": [
+        1
+      ],
+      "type": "integer"
+    },
+    "is_private": {
+      "description": "Whether access to the status page is restricted by a password, a secret token or an IP allowlist",
+      "examples": [
+        false
+      ],
+      "type": "boolean"
+    },
+    "name": {
+      "description": "Status page name",
+      "examples": [
+        "Phare status"
+      ],
+      "type": "string"
+    },
+    "project_id": {
+      "description": "Parent project ID",
+      "examples": [
+        1
+      ],
+      "type": "integer"
+    },
+    "search_engine_indexed": {
+      "description": "Whether search engines are allowed to index the page",
+      "examples": [
+        true
+      ],
+      "type": "boolean"
+    },
+    "show_response_times": {
+      "default": true,
+      "description": "Whether to display response times for monitors on the status page",
+      "examples": [
+        true
+      ],
+      "type": "boolean"
+    },
+    "subdomain": {
+      "description": "Subdomain name for the status page, hosted on a phare.io domain: {subdomain}.status.phare.io",
+      "examples": [
+        "example"
+      ],
+      "type": "string"
+    },
+    "subscription_channels": {
+      "description": "List of active subscription channels",
+      "items": {
+        "enum": [
+          "rss",
+          "atom",
+          "slack"
+        ],
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "tags": {
+      "description": "Resource tags, made of lowercase letters, numbers, `.`, `_`, `:` and `-`. An organization can have up to 200 tags.",
+      "items": {
+        "examples": [
+          "environment:production"
+        ],
+        "type": "string"
+      },
+      "type": [
+        "array",
+        "null"
+      ]
+    },
+    "theme": {
+      "description": "Theme settings to customize the status page",
+      "properties": {
+        "border_width": {
+          "default": 1,
+          "description": "Width of the borders, in pixels, from 2 the icons are drawn bolder too",
+          "examples": [
+            2
+          ],
+          "type": "integer"
+        },
+        "dark": {
+          "description": "Dark theme colors, as lowercase 6-digit hexadecimal codes",
+          "properties": {
+            "background": {
+              "description": "Page background color",
+              "examples": [
+                "#111111"
+              ],
+              "type": "string"
+            },
+            "background_card": {
+              "description": "Background color of the cards",
+              "examples": [
+                "#1a1a1a"
+              ],
+              "type": "string"
+            },
+            "border": {
+              "description": "Border color",
+              "examples": [
+                "#3f3f46"
+              ],
+              "type": "string"
+            },
+            "degraded_performance": {
+              "description": "Color of the degraded performance status, and of the timeline days with a degraded performance incident",
+              "examples": [
+                "#fbbf24"
+              ],
+              "type": "string"
+            },
+            "empty": {
+              "description": "Color of the timeline days without data, before the monitor was created",
+              "examples": [
+                "#d3d3d3"
+              ],
+              "type": "string"
+            },
+            "foreground": {
+              "description": "Text color",
+              "examples": [
+                "#ffffff"
+              ],
+              "type": "string"
+            },
+            "foreground_muted": {
+              "description": "Secondary text color",
+              "examples": [
+                "#959595"
+              ],
+              "type": "string"
+            },
+            "maintenance": {
+              "description": "Color of the maintenance status, and of the timeline days with a maintenance",
+              "examples": [
+                "#6366f1"
+              ],
+              "type": "string"
+            },
+            "major_outage": {
+              "description": "Color of the major outage status, and of the timeline days with a major outage incident",
+              "examples": [
+                "#ef4444"
+              ],
+              "type": "string"
+            },
+            "operational": {
+              "description": "Color of the operational status, and of the timeline days without incident",
+              "examples": [
+                "#16a34a"
+              ],
+              "type": "string"
+            },
+            "partial_outage": {
+              "description": "Color of the partial outage status, and of the timeline days with a partial outage incident",
+              "examples": [
+                "#f59e0b"
+              ],
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "light": {
+          "description": "Light theme colors, as lowercase 6-digit hexadecimal codes",
+          "properties": {
+            "background": {
+              "description": "Page background color",
+              "examples": [
+                "#ffffff"
+              ],
+              "type": "string"
+            },
+            "background_card": {
+              "description": "Background color of the cards",
+              "examples": [
+                "#fafafa"
+              ],
+              "type": "string"
+            },
+            "border": {
+              "description": "Border color",
+              "examples": [
+                "#e5e5e5"
+              ],
+              "type": "string"
+            },
+            "degraded_performance": {
+              "description": "Color of the degraded performance status, and of the timeline days with a degraded performance incident",
+              "examples": [
+                "#fbbf24"
+              ],
+              "type": "string"
+            },
+            "empty": {
+              "description": "Color of the timeline days without data, before the monitor was created",
+              "examples": [
+                "#d3d3d3"
+              ],
+              "type": "string"
+            },
+            "foreground": {
+              "description": "Text color",
+              "examples": [
+                "#000000"
+              ],
+              "type": "string"
+            },
+            "foreground_muted": {
+              "description": "Secondary text color",
+              "examples": [
+                "#737373"
+              ],
+              "type": "string"
+            },
+            "maintenance": {
+              "description": "Color of the maintenance status, and of the timeline days with a maintenance",
+              "examples": [
+                "#6366f1"
+              ],
+              "type": "string"
+            },
+            "major_outage": {
+              "description": "Color of the major outage status, and of the timeline days with a major outage incident",
+              "examples": [
+                "#ef4444"
+              ],
+              "type": "string"
+            },
+            "operational": {
+              "description": "Color of the operational status, and of the timeline days without incident",
+              "examples": [
+                "#16a34a"
+              ],
+              "type": "string"
+            },
+            "partial_outage": {
+              "description": "Color of the partial outage status, and of the timeline days with a partial outage incident",
+              "examples": [
+                "#f59e0b"
+              ],
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "rounded": {
+          "default": true,
+          "description": "Whether the corners of the page elements are rounded, square otherwise",
+          "examples": [
+            true
+          ],
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "timeframe": {
+      "description": "Number of days of status and incident history to display.",
+      "enum": [
+        30,
+        60,
+        90
+      ],
+      "examples": [
+        90
+      ],
+      "type": "integer"
+    },
+    "timezone": {
+      "default": "UTC",
+      "description": "Timezone used to split the status page timeline into days and to display all dates on the status page and in feeds. Must be a canonical IANA timezone identifier (case-sensitive, e.g. `Europe/Paris`, `America/New_York` or `UTC`).",
+      "examples": [
+        "Europe/Paris"
+      ],
+      "type": "string"
+    },
+    "title": {
+      "description": "Status page HTML title",
+      "examples": [
+        "Phare status"
+      ],
+      "type": "string"
+    },
+    "updated_at": {
+      "description": "Date of last update for the entity",
+      "format": "date-time",
+      "type": "string"
+    },
+    "website_url": {
+      "description": "URL to redirect users clicking the status page logo",
+      "examples": [
+        "https://phare.io"
+      ],
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

First observedNov 7, 2026

TDQS

A3.8/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare destructiveHint=true and idempotentHint=true, so the safety profile is covered. The description adds genuinely valuable behavior the annotations cannot convey: components are fully replaced rather than merged, a new domain triggers automatic certificate issuance contingent on a CNAME record, and logo/favicon uploads require multipart/form-data. These are the operational gotchas an agent would otherwise miss.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three sentences, no filler, with the partial-update rule front-loaded ahead of the field-specific caveats. Slightly dense with lowercase field names in prose, but every sentence carries non-obvious information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 24-parameter mutation tool with nested theme/components objects and an output schema, the description covers the highest-risk behaviors an agent must know before calling. It leaves plan-gated fields (access_ips, access_password requiring Scale) and destructive scope to the schema/annotations, which is reasonable given their coverage.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3. The description earns above baseline by explaining replacement semantics for `components`, the certificate/CNAME consequence of setting `domain`, and the multipart constraint for the binary logo/favicon fields, all of which add meaning the schema's per-field descriptions do not imply.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb and resource ('Update a status page by ID') and immediately clarifies the partial-update semantics, so the agent knows exactly what the tool acts on. It does not explicitly contrast with update_project or create_status_page, but the name plus resource make the target unambiguous.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The 'fields left out keep their current value' clause implies this is the tool to use for partial modifications rather than full replacement, which is useful implied guidance. However, there is no explicit statement of when to prefer this over get_status_page or create_status_page, and no prerequisites or preconditions are named.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Phare tools Inspect

Try in Browser

Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?