create_status_page
Create a status page — a single page showing the current status and recent history of a chosen set of monitors. Reach for this when the health of a monitor needs to be visible to someone who cannot log in to the project. Pages are PRIVATE unless you ask for otherwise; read the visibility parameter before making one public.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slug | No | Optional URL slug, which is what appears in the public link (/status/<slug>). Must match ^[a-z0-9][a-z0-9-]{1,48}[a-z0-9]$ (3-50 chars, lowercase alphanumeric and hyphens, starting and ending alphanumeric). Slugs are GLOBALLY unique across all projects, not just yours, so a desirable one may be taken — that returns 409. OMIT IT unless the user asked for a specific URL: a random unguessable slug is then generated, which is also the safer default for a public page. | |
| title | Yes | Human-readable page title, e.g. 'Acme API Status'. Shown at the top of the page, and to anyone the page is shared with. | |
| check_ids | No | Comma-separated monitor UUIDs to show on the page, in no particular order. Get them from list_monitors. Every id must belong to this project — an unknown or cross-project id returns 400 and nothing is saved. An empty value is legal and produces a page with no monitors on it. | |
| visibility | No | 'private' (default) or 'public'. 'public' means the page is served at a guessable-free but UNAUTHENTICATED URL: anyone with the link sees the title, the name of every monitor on it, and its up/down history. Monitor names are frequently internal ('billing-reconciler', 'acme-corp-nightly-sync'), so treat this as publishing them. Choose 'private' unless the user has actually asked for a page other people can see. The free tier allows exactly ONE public page per project; a second returns 403. |