---
title: "Update status page"
method: PATCH
path: "/api/v2/statuspages/{page_id}"
tags: ["Status Pages"]
---

# Update status page

`PATCH /api/v2/statuspages/{page_id}`

Updates an existing status page's attributes. **Note**: Publishing and unpublishing via the `enabled` property will be deprecated on this endpoint. Use the dedicated [publish](#publish-status-page) and [unpublish](#unpublish-status-page) status page endpoints instead.

## Path parameters

- `page_id` string, uuid, required

## Query parameters

- `delete_subscribers` boolean
- `include` string

## Request body

- PatchStatusPageRequest — Request object for updating a status page.
  - `data` PatchStatusPageRequestData — The data object for updating a status page.
    - `attributes` PatchStatusPageRequestDataAttributes, required — The supported attributes for updating a status page.
      - `company_logo` string — The base64-encoded image data displayed on the status page.
      - `domain_prefix` string — The subdomain of the status page's url taking the form `https://{domain_prefix}.statuspage.datadoghq.com`. Globally unique across Datadog Status Pages.
      - `email_header_image` string — The base64-encoded image data displayed in email notifications sent to status page subscribers.
      - `enabled` boolean — Whether the status page is enabled.
      - `favicon` string — The base64-encoded image data displayed in the browser tab.
      - `name` string — The name of the status page.
      - `slack_app_icon` string — The Slack app icon URL for the status page.
      - `slack_subscriptions_enabled` boolean — Whether Slack subscriptions are enabled for the status page.
      - `subscriptions_enabled` boolean — Whether users can subscribe to the status page.
      - `type` 'public' | 'internal' — The type of the status page controlling how the status page is accessed.
      - `visualization_type` 'bars_and_uptime_percentage' | 'bars_only' | 'component_name_only' — The visualization type of the status page.
    - `id` string, uuid, required — The ID of the status page.
    - `type` 'status_pages', required — Status pages resource type.

## Response `200`

OK

- StatusPage — Response object for a single status page.
  - `data` StatusPageData — The data object for a status page.
    - `attributes` StatusPageDataAttributes — The attributes of a status page.
      - `company_logo` string, nullable — Base64-encoded image data displayed on the status page.
      - `components` StatusPageDataAttributesComponentsItems[] — Components displayed on the status page.
        - `components` StatusPageDataAttributesComponentsItemsComponentsItems[] — If the component is of type `group`, the components within the group.
          - `id` string, uuid — The ID of the component.
          - `name` string — The name of the component.
          - `position` integer — The zero-indexed position of the component. Relative to the other components in the group.
          - `status` 'operational' | 'degraded' | 'partial_outage' | 'major_outage' | 'maintenance' — The status of the component.
          - `type` 'component' — The type of the component.
        - `id` string, uuid — The ID of the component.
        - `name` string — The name of the component.
        - `position` integer — The zero-indexed position of the component.
        - `status` 'operational' | 'degraded' | 'partial_outage' | 'major_outage' | 'maintenance' — The status of the component.
        - `type` 'component' | 'group' — The type of the component.
      - `created_at` string, date-time — Timestamp of when the status page was created.
      - `custom_domain` string, nullable — If configured, the url that the status page is accessible at.
      - `custom_domain_enabled` boolean — Whether the custom domain is configured.
      - `domain_prefix` string — The subdomain of the status page's url taking the form `https://{domain_prefix}.statuspage.datadoghq.com`. Globally unique across Datadog Status Pages.
      - `email_header_image` string, nullable — Base64-encoded image data included in email notifications sent to status page subscribers.
      - `enabled` boolean — Whether the status page is enabled.
      - `favicon` string, nullable — Base64-encoded image data displayed in the browser tab.
      - `modified_at` string, date-time — Timestamp of when the status page was last modified.
      - `name` string — The name of the status page.
      - `page_url` string — The url that the status page is accessible at.
      - `slack_app_icon` string — The Slack app icon URL for the status page.
      - `slack_subscriptions_enabled` boolean — Whether Slack subscriptions are enabled for the status page.
      - `subscriptions_enabled` boolean — Whether users can subscribe to the status page.
      - `type` 'public' | 'internal' — The type of the status page controlling how the status page is accessed.
      - `visualization_type` 'bars_and_uptime_percentage' | 'bars_only' | 'component_name_only' — The visualization type of the status page.
    - `id` string, uuid — The ID of the status page.
    - `relationships` StatusPageDataRelationships — The relationships of a status page.
      - `created_by_user` StatusPageDataRelationshipsCreatedByUser — The Datadog user who created the status page.
        - `data` StatusPageDataRelationshipsCreatedByUserData, required — The data object identifying the Datadog user who created the status page.
          - `id` string, required — The ID of the Datadog user who created the status page.
          - `type` 'users', required — Users resource type.
      - `last_modified_by_user` StatusPageDataRelationshipsLastModifiedByUser — The Datadog user who last modified the status page.
        - `data` StatusPageDataRelationshipsLastModifiedByUserData, required — The data object identifying the Datadog user who last modified the status page.
          - `id` string, required — The ID of the Datadog user who last modified the status page.
          - `type` 'users', required — Users resource type.
    - `type` 'status_pages', required — Status pages resource type.
  - `included` StatusPageArrayIncluded[] — The included related resources of a status page. Client must explicitly request these resources by name in the `include` query parameter.
    - `attributes` StatusPagesUserAttributes — Attributes of the Datadog user.
      - `email` string — The email of the Datadog user.
      - `handle` string — The handle of the Datadog user.
      - `icon` string — The icon of the Datadog user.
      - `name` string — The name of the Datadog user.
      - `uuid` string — The UUID of the Datadog user.
    - `id` string, uuid — The ID of the Datadog user.
    - `type` 'users', required — Users resource type.

## Other responses

- `429` — Too many requests

---

[API](https://skmtc.net/datadog/apis/api-v2.md) · [All operations](https://skmtc.net/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v2/revisions/da68bf029e4c/schema)