Skip to main content
POST
Create a status page

Authorizations

Authorization
string
header
required

API key (dh_live_...) or Auth0 JWT token

Headers

Idempotency-Key
string

Replays the stored response for 24h when the same key is sent again (1–255 visible ASCII)

X-DevHelm-Client
string

Calling surface and version, e.g. cli/1.4.0 or sdk-js/2.0.0

Body

application/json
name
string
required

Human-readable name for this status page

Maximum string length: 255
slug
string
required

URL slug (lowercase, hyphens, globally unique)

Required string length: 3 - 63
Pattern: ^[a-z0-9][a-z0-9-]*[a-z0-9]$
description
string | null

Optional description shown below the page header

Maximum string length: 500
branding
object | null

Updated branding configuration; null preserves current

visibility
enum<string> | null

Page visibility: PUBLIC, PASSWORD, or IP_RESTRICTED (default: PUBLIC)

Available options:
PUBLIC,
PASSWORD,
IP_RESTRICTED,
LOGIN_REQUIRED
enabled
boolean | null

Whether the page is enabled (default: true)

incidentMode
enum<string> | null

Incident mode: MANUAL, REVIEW, or AUTOMATIC (default: AUTOMATIC)

Available options:
MANUAL,
REVIEW,
AUTOMATIC
managedBy
enum<string> | null

Source creating this page: DASHBOARD, GIT, TERRAFORM, MCP or API (CLI = GIT until 2027-01-31). Defaults to API when omitted.

Available options:
DASHBOARD,
CLI,
TERRAFORM,
MCP,
API,
GIT

Response

Created

data
object
required