StatusPageResource

Update a status page

Updates an existing status page by ID, including services, branding, and public visibility options.

Required API key permissions

  • Scope: status-pages:update
  • Accepted key types: organization API key (org-wide), personal access token (org-wide)
  • Access: Operates on a single organization. Pass organizationId when your API key spans multiple organizations.
  • Required organization role (user-linked keys only): Administrator
  • Organization API keys are not subject to organization or team role checks.
put/api/public/v1/status-page/{id}

Request

Path parameters

idstring uuid required

Query parameters

organizationIdstring uuid
provisionboolean

When true, the created or updated resource is marked as provisioned and becomes read-only in the web UI. Defaults to false on create. On update, omitting this parameter preserves the existing provisioned state. Not available for personal access tokens.

Request body

displayNamestring nullable
slugstring nullable
publicTitlestring nullable
publicDescriptionstring nullable
serviceIdsstring[] nullable
publicCompanyUrlstring nullable
publicCompanyNamestring nullable
publicSupportUrlstring nullable
publicSupportEmailstring nullable
historyInDaysinteger
timeZoneIdstring nullable
disablePublicSubscriptionboolean
disablePublicPageboolean
disablePublicJsonboolean
enableSMSSubscriptionboolean nullable
publicSeverityMappingMinorstring nullable
publicSeverityMappingWarningstring nullable
publicSeverityMappingCriticalstring nullable
bannerBackgroundColorstring nullable
bannerBackgroundColorDarkModestring nullable
bannerTextColorstring nullable
bannerTextColorDarkModestring nullable
bodyBackgroundColorstring nullable
bodyBackgroundColorDarkModestring nullable
secondaryBackgroundColorstring nullable
secondaryBackgroundColorDarkModestring nullable
primaryTextColorstring nullable
primaryTextColorDarkModestring nullable
secondaryTextColorstring nullable
secondaryTextColorDarkModestring nullable
buttonBackgroundColorstring nullable
buttonBackgroundColorDarkModestring nullable
buttonTextColorstring nullable
buttonTextColorDarkModestring nullable
privateIpFilterstring nullable
privateUserAuthenticationRequiredboolean nullable
decimalPlacesinteger nullable
publicDisplayLiveStateOnlyboolean
publicHideIncidentDetailsboolean
publicHideMaintenancesboolean
passwordProtectionPasswordstring nullable

Response

OK

idstring uuid
isProvisionedboolean
displayNamestring nullable
publicTitlestring nullable
publicDescriptionstring nullable
slugstring nullable
timeZoneIdstring nullable
publicCompanyNamestring nullable
publicCompanyUrlstring nullable
publicSupportUrlstring nullable
publicSupportEmailstring nullable
historyInDaysinteger
disablePublicSubscriptionboolean
disablePublicPageboolean nullable
disablePublicJsonboolean nullable
publicSeverityMappingMinorstring nullable
publicSeverityMappingWarningstring nullable
publicSeverityMappingCriticalstring nullable
serviceIdsstring[] nullable
publicBannerBackgroundColorstring nullable
publicBannerBackgroundColorDarkModestring nullable
publicBannerTextColorstring nullable
publicBannerTextColorDarkModestring nullable
bannerBackgroundColorstring nullable
bannerBackgroundColorDarkModestring nullable
bannerTextColorstring nullable
bannerTextColorDarkModestring nullable
bodyBackgroundColorstring nullable
bodyBackgroundColorDarkModestring nullable
secondaryBackgroundColorstring nullable
secondaryBackgroundColorDarkModestring nullable
primaryTextColorstring nullable
primaryTextColorDarkModestring nullable
secondaryTextColorstring nullable
secondaryTextColorDarkModestring nullable
buttonBackgroundColorstring nullable
buttonBackgroundColorDarkModestring nullable
buttonTextColorstring nullable
buttonTextColorDarkModestring nullable
privateIpFilterstring nullable
privateUserAuthenticationRequiredboolean nullable
enableSMSSubscriptionboolean nullable
decimalPlacesinteger nullable
publicDisplayLiveStateOnlyboolean
publicHideIncidentDetailsboolean
publicHideMaintenancesboolean
isPasswordProtectionPasswordConfiguredboolean

Changes

No recorded changes to this operation across all 1 revision of this API.