Skip to main content
POST
Create a status page

Authorizations

Authorization
string
header
required

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

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
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, CLI, TERRAFORM, MCP, or API. Defaults to API when omitted.

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

Response

Created

data
object
required