Skip to main content
PUT
Update a status page

Authorizations

Authorization
string
header
required

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

Headers

X-DevHelm-Client
string

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

Path Parameters

id
string<uuid>
required

Body

application/json
name
string | null

New name; null preserves current

Maximum string length: 255
description
string | null

New description; null preserves current, empty string clears

Maximum string length: 500
branding
object | null

Updated branding configuration; null preserves current

visibility
enum<string> | null

Page visibility; null preserves current

Available options:
PUBLIC,
PASSWORD,
IP_RESTRICTED,
LOGIN_REQUIRED
emailSignIn
enum<string> | null

Email sign-in method besides SSO: PASSWORD or MAGIC_LINK; null preserves current

Available options:
PASSWORD,
MAGIC_LINK
clearEmailSignIn
boolean | null

Set to true to turn email sign-in off

enabled
boolean | null

Whether the page is enabled; null preserves current

incidentMode
enum<string> | null

Incident mode: MANUAL, REVIEW, or AUTOMATIC; null preserves current

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

New attribution source: DASHBOARD, GIT, TERRAFORM, MCP or API (CLI = GIT until 2027-01-31); null preserves current value.

Available options:
DASHBOARD,
CLI,
TERRAFORM,
MCP,
API,
GIT
subscriberChannels
enum<string>[] | null

Channels visitors can subscribe with (EMAIL, TEAMS, WEBHOOK); null preserves current

Maximum array length: 3

Channels visitors can subscribe with (EMAIL, TEAMS, WEBHOOK); null preserves current

Available options:
EMAIL,
SMS,
WEBHOOK,
TEAMS
confirmPublic
boolean | null

Confirms making a sign-in page public, which signs out its viewers

confirmConvertSubscribers
boolean | null

Confirms making a page private converts its email subscribers to invited end users

Response

OK

data
object
required