Skip to main content
POST
Update status page

Restrictions

Authorizations

app_key
string
query
required

App key issued from the Flashduty console under Account → APP Keys. Required on every public API call. Keep it secret — it grants the same access as the owning account.

Body

application/json

Parameters for updating an existing status page. All fields except page_id are optional; omit a field or pass null to keep its existing value.

page_id
integer<int64>
required

Status page ID; obtain it from GET /status-page/list.

name
string | null

Display name of the status page. Omit or pass null to keep the existing value.

Maximum string length: 255
url_name
string | null

URL-safe slug, unique per account and page type. Omit or pass null to keep the existing value.

Maximum string length: 255
custom_domain
string | null

Custom domain for a public status page. Omit or pass null to keep the existing value.

Maximum string length: 255
page_title
string | null

Browser title shown for the status page. Omit or pass null to keep the existing value.

logo
string | null

Logo image of the status page. Omit or pass null to keep the existing value.

dark_logo
string | null

Dark-mode logo image of the status page. Omit or pass null to keep the existing value.

logo_url
string | null

URL opened when the logo is clicked. Omit or pass null to keep the existing value.

Maximum string length: 255
favicon
string | null

Favicon of the status page. Omit or pass null to keep the existing value.

page_header
string | null

Header content shown on the status page. Omit or pass null to keep the existing value.

Footer content shown on the status page. Omit or pass null to keep the existing value.

date_view
enum<string> | null

How change dates are displayed. Leave empty to keep the current value. calendar uses a calendar view; list uses a list view.

Available options:
calendar,
list
display_uptime_mode
enum<string> | null

How uptime is displayed. Leave empty to keep the current value. chart_and_percentage shows both chart and percentage; chart shows only the chart; none hides uptime.

Available options:
chart_and_percentage,
chart,
none

Custom navigation links shown on the status page. Omit or pass an empty array to keep the current links.

contact_info
string | null

Get-in-touch contact, such as a mailto or website URL. Omit or pass null to keep the existing value.

subscription
object

Subscription channel toggles. Omit or pass null to keep the existing value.

template_preference
string | null

Preferred event template type: pre_defined or message. Omit or pass null to keep the existing value.

Response

Success

Success response envelope. On every 2xx response, request_id identifies the call (also mirrored in the Flashcat-Request-Id header) and data holds the endpoint-specific payload. Failure responses use a different shape — see ErrorResponse.

request_id
string
required

Unique ID for this request. Mirrored in the Flashcat-Request-Id response header. Include it when reporting issues.

Example:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

data
object
required

Empty response body. The server returns data: null on success.