Status / Create

Create a status page. Do not send guid; the server assigns one. New pages start as draft with an empty layout.

Endpoint

Method POST
Url https://downdar.com/api/v1/status/create

Request

Fields

name req String, max 255 characters.
title_url opt Optional http or https URL for the page title link.
theme opt dark (default), light
display_mode opt compact (default), detailed
show_targets opt Boolean. Defaults to false.
page_background_hex opt Hex color. Defaults from the selected theme.
header_color_hex opt Hex color. Defaults from the selected theme.
text_color_hex opt Hex color. Defaults from the selected theme.
{ "name": "Production status" }

Response

Top level

ok Always true on success.
status_page Status page object. Fields below apply to status_page.
capacity Status page quota for the account.
rate_limit Rate limit state for the tier this endpoint consumes. Present on every successful response.

status_page

guid Status page id.
name Page name.
published Always draft immediately after create.
layout Empty until you update the page.
monitor_count Always 0 immediately after create.

capacity

limit Maximum status pages allowed on your plan.
used Status pages currently in use.
remaining Status pages you can still create.

rate_limit

tier Rate tier this endpoint counts against (1-5).
cost Units consumed by this request against the tier window.
timeframe Rolling limit window: second, minute, hour, or day.
limit Maximum units allowed in the timeframe for this tier on your plan.
used Units already used in the current window.
remaining Units left before this tier returns HTTP 429.
{ "ok": true, "status_page": { "guid": "550e8400-e29b-41d4-a716-446655440000", "name": "Production status", "title_url": "", "theme": "dark", "display_mode": "compact", "show_targets": false, "page_background_hex": "#262626", "header_color_hex": "#1C1C1C", "text_color_hex": "#BBBBBB", "published": "draft", "noindex": false, "public_url": "https://example.com/status/550e8400-e29b-41d4-a716-446655440000", "embed_origins": [], "layout": { "sections": [], "monitors": [] }, "monitor_count": 0 }, "capacity": { "limit": 5, "used": 1, "remaining": 4 }, "rate_limit": { "tier": 1, "cost": 1, "timeframe": "minute", "limit": 60, "used": 12, "remaining": 48 } }