Update Status Pages API documentation to reflect deprecation of creating a published status page

.generator/schemas/v2/openapi.yaml

@@ -17311,7 +17311,6 @@ components:
                 type: component
             domain_prefix: status-page-us1
             email_header_image: data:image/png;base64,pQSLAw0KGgoAAAANSUhEUgAAAQ4AASJKFF
-            enabled: true
             favicon: data:image/png;base64,kWMRNw0KGgoAAAANSUhEUgAAAEAAAABACA
             name: Status Page US1
             subscriptions_enabled: true
@@ -17370,10 +17369,6 @@ components:
           description: Base64-encoded image data included in email notifications sent to status page subscribers.
           example: data:image/png;base64,pQSLAw0KGgoAAAANSUhEUgAAAQ4AASJKFF
           type: string
-        enabled:
-          description: Whether the status page is enabled.
-          example: true
-          type: boolean
         favicon:
           description: Base64-encoded image data displayed in the browser tab.
           example: data:image/png;base64,kWMRNw0KGgoAAAANSUhEUgAAAEAAAABACA
@@ -17394,7 +17389,6 @@ components:
           example: bars_and_uptime_percentage
       required:
         - domain_prefix
-        - enabled
         - name
         - type
         - visualization_type
@@ -127386,7 +127380,7 @@ paths:
         permissions:
           - status_pages_settings_read
     post:
-      description: "Creates a new status page. **Note**: Publishing a status page on creation via the `enabled` property will be deprecated. Use the dedicated [publish](#publish-status-page) status page endpoint after creation instead."
+      description: "Creates a new status page in an unpublished state. Use the dedicated [publish](#publish-status-page) status page endpoint to publish the page after creation."
       operationId: CreateStatusPage
       parameters:
         - description: "Comma-separated list of resources to include. Supported values: created_by_user, last_modified_by_user."
@@ -127422,7 +127416,6 @@ paths:
                           type: component
                       domain_prefix: status-page-us1
                       email_header_image: data:image/png;base64,pQSLAw0KGgoAAAANSUhEUgAAAQ4AASJKFF
-                      enabled: true
                       favicon: data:image/png;base64,kWMRNw0KGgoAAAANSUhEUgAAAEAAAABACA
                       name: Status Page US1
                       subscriptions_enabled: true

examples/v2/status-pages/CreateStatusPage.py

@@ -38,7 +38,6 @@
                     position=1,
                 ),
             ],
-            enabled=True,
             type=CreateStatusPageRequestDataAttributesType.INTERNAL,
             visualization_type=CreateStatusPageRequestDataAttributesVisualizationType.BARS_AND_UPTIME_PERCENTAGE,
         ),

examples/v2/status-pages/PublishStatusPage.py

@@ -6,12 +6,12 @@
 from datadog_api_client import ApiClient, Configuration
 from datadog_api_client.v2.api.status_pages_api import StatusPagesApi
 
-# there is a valid "unpublished_status_page" in the system
-UNPUBLISHED_STATUS_PAGE_DATA_ID = environ["UNPUBLISHED_STATUS_PAGE_DATA_ID"]
+# there is a valid "status_page" in the system
+STATUS_PAGE_DATA_ID = environ["STATUS_PAGE_DATA_ID"]
 
 configuration = Configuration()
 with ApiClient(configuration) as api_client:
     api_instance = StatusPagesApi(api_client)
     api_instance.publish_status_page(
-        page_id=UNPUBLISHED_STATUS_PAGE_DATA_ID,
+        page_id=STATUS_PAGE_DATA_ID,
     )

examples/v2/status-pages/UnpublishStatusPage.py

@@ -2,16 +2,13 @@
 Unpublish status page returns "No Content" response
 """
 
-from os import environ
 from datadog_api_client import ApiClient, Configuration
 from datadog_api_client.v2.api.status_pages_api import StatusPagesApi
-
-# there is a valid "status_page" in the system
-STATUS_PAGE_DATA_ID = environ["STATUS_PAGE_DATA_ID"]
+from uuid import UUID
 
 configuration = Configuration()
 with ApiClient(configuration) as api_client:
     api_instance = StatusPagesApi(api_client)
     api_instance.unpublish_status_page(
-        page_id=STATUS_PAGE_DATA_ID,
+        page_id=UUID("9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d"),
     )

src/datadog_api_client/v2/api/status_pages_api.py

@@ -845,7 +845,7 @@ def create_status_page(
     ) -> StatusPage:
         """Create status page.
 
-        Creates a new status page. **Note** : Publishing a status page on creation via the ``enabled`` property will be deprecated. Use the dedicated `publish <#publish-status-page>`_ status page endpoint after creation instead.
+        Creates a new status page in an unpublished state. Use the dedicated `publish <#publish-status-page>`_ status page endpoint to publish the page after creation.
 
         :type body: CreateStatusPageRequest
         :param include: Comma-separated list of resources to include. Supported values: created_by_user, last_modified_by_user.

src/datadog_api_client/v2/model/create_status_page_request_data_attributes.py

@@ -43,7 +43,6 @@ def openapi_types(_):
             "components": ([CreateStatusPageRequestDataAttributesComponentsItems],),
             "domain_prefix": (str,),
             "email_header_image": (str,),
-            "enabled": (bool,),
             "favicon": (str,),
             "name": (str,),
             "subscriptions_enabled": (bool,),
@@ -56,7 +55,6 @@ def openapi_types(_):
         "components": "components",
         "domain_prefix": "domain_prefix",
         "email_header_image": "email_header_image",
-        "enabled": "enabled",
         "favicon": "favicon",
         "name": "name",
         "subscriptions_enabled": "subscriptions_enabled",
@@ -67,7 +65,6 @@ def openapi_types(_):
     def __init__(
         self_,
         domain_prefix: str,
-        enabled: bool,
         name: str,
         type: CreateStatusPageRequestDataAttributesType,
         visualization_type: CreateStatusPageRequestDataAttributesVisualizationType,
@@ -93,9 +90,6 @@ def __init__(
         :param email_header_image: Base64-encoded image data included in email notifications sent to status page subscribers.
         :type email_header_image: str, optional
 
-        :param enabled: Whether the status page is enabled.
-        :type enabled: bool
-
         :param favicon: Base64-encoded image data displayed in the browser tab.
         :type favicon: str, optional
 
@@ -124,7 +118,6 @@ def __init__(
         super().__init__(kwargs)
 
         self_.domain_prefix = domain_prefix
-        self_.enabled = enabled
         self_.name = name
         self_.type = type
         self_.visualization_type = visualization_type

tests/v2/cassettes/test_scenarios/test_create_component_returns_created_response.frozen

@@ -1 +1 @@
-2026-03-31T18:43:45.443Z
+2026-04-24T14:12:37.493Z

tests/v2/cassettes/test_scenarios/test_create_component_returns_created_response.yaml

@@ -1,6 +1,6 @@
 interactions:
 - request:
-    body: '{"data":{"attributes":{"components":[{"components":[{"name":"Login","position":0,"type":"component"},{"name":"Settings","position":1,"type":"component"}],"name":"Application","type":"group"}],"domain_prefix":"9dbd15ff66733c82","enabled":true,"name":"A
+    body: '{"data":{"attributes":{"components":[{"components":[{"name":"Login","position":0,"type":"component"},{"name":"Settings","position":1,"type":"component"}],"name":"Application","type":"group"}],"domain_prefix":"f456820b7958024f","name":"A
       Status Page","type":"internal","visualization_type":"bars_and_uptime_percentage"},"type":"status_pages"}}'
     headers:
       accept:
@@ -11,8 +11,8 @@ interactions:
     uri: https://api.datadoghq.com/api/v2/statuspages
   response:
     body:
-      string: '{"data":{"id":"daae96b1-2114-4979-8668-2f782fe4a82b","type":"status_pages","attributes":{"company_logo":null,"components":[{"id":"0827c72a-5886-4850-b9a0-3c0b62fd5cbd","name":"Application","type":"group","position":0,"components":[{"id":"2944ac68-cc1f-43bc-9950-a81912daf613","name":"Login","type":"component","status":"operational","position":0},{"id":"7374a8e5-7d66-43be-83f0-4337a739bdfb","name":"Settings","type":"component","status":"operational","position":1}]}],"created_at":"2026-03-31T18:43:45.548049Z","custom_domain":null,"custom_domain_enabled":false,"domain_prefix":"9dbd15ff66733c82","email_header_image":null,"enabled":true,"favicon":null,"modified_at":"2026-03-31T18:43:45.548049Z","name":"A
-        Status Page","page_url":"https://frog.datadoghq.com/status-pages/daae96b1-2114-4979-8668-2f782fe4a82b/view","subscriptions_enabled":false,"type":"internal","visualization_type":"bars_and_uptime_percentage"},"relationships":{"created_by_user":{"data":{"id":"3ad549bf-eba0-11e9-a77a-0705486660d0","type":"users"}},"last_modified_by_user":{"data":{"id":"3ad549bf-eba0-11e9-a77a-0705486660d0","type":"users"}}}}}'
+      string: '{"data":{"id":"b02801ff-949d-467e-967d-5943c8f1c7af","type":"status_pages","attributes":{"company_logo":null,"components":[{"id":"7f96e5c3-f033-4640-bf8a-7018e134c8b5","name":"Application","type":"group","position":0,"components":[{"id":"feefa8d8-7485-4bfb-82a6-86268c1d68b3","name":"Login","type":"component","status":"operational","position":0},{"id":"b2f95a96-3261-40fb-bb5a-f95203741608","name":"Settings","type":"component","status":"operational","position":1}]}],"created_at":"2026-04-24T14:12:37.623742Z","custom_domain":null,"custom_domain_enabled":false,"domain_prefix":"f456820b7958024f","email_header_image":null,"enabled":false,"favicon":null,"modified_at":"2026-04-24T14:12:37.623742Z","name":"A
+        Status Page","page_url":"https://frog.datadoghq.com/status-pages/b02801ff-949d-467e-967d-5943c8f1c7af/view","subscriptions_enabled":false,"type":"internal","visualization_type":"bars_and_uptime_percentage"},"relationships":{"created_by_user":{"data":{"id":"3ad549bf-eba0-11e9-a77a-0705486660d0","type":"users"}},"last_modified_by_user":{"data":{"id":"3ad549bf-eba0-11e9-a77a-0705486660d0","type":"users"}}}}}'
     headers:
       content-type:
       - application/vnd.api+json
@@ -27,10 +27,10 @@ interactions:
       content-type:
       - application/json
     method: POST
-    uri: https://api.datadoghq.com/api/v2/statuspages/daae96b1-2114-4979-8668-2f782fe4a82b/components
+    uri: https://api.datadoghq.com/api/v2/statuspages/b02801ff-949d-467e-967d-5943c8f1c7af/components
   response:
     body:
-      string: '{"data":{"id":"dc1f6182-86a0-4f18-a4de-78f99ff1455f","type":"components","attributes":{"created_at":"2026-03-31T18:43:46.083871Z","modified_at":"2026-03-31T18:43:46.083871Z","name":"Logs","position":0,"status":"operational","type":"component"},"relationships":{"created_by_user":{"data":{"id":"3ad549bf-eba0-11e9-a77a-0705486660d0","type":"users"}},"group":{"data":null},"last_modified_by_user":{"data":{"id":"3ad549bf-eba0-11e9-a77a-0705486660d0","type":"users"}},"status_page":{"data":{"id":"daae96b1-2114-4979-8668-2f782fe4a82b","type":"status_pages"}}}}}'
+      string: '{"data":{"id":"ef964967-c6b6-465a-a260-0468b697036c","type":"components","attributes":{"created_at":"2026-04-24T14:12:38.188993Z","modified_at":"2026-04-24T14:12:38.188993Z","name":"Logs","position":0,"status":"operational","type":"component"},"relationships":{"created_by_user":{"data":{"id":"3ad549bf-eba0-11e9-a77a-0705486660d0","type":"users"}},"group":{"data":null},"last_modified_by_user":{"data":{"id":"3ad549bf-eba0-11e9-a77a-0705486660d0","type":"users"}},"status_page":{"data":{"id":"b02801ff-949d-467e-967d-5943c8f1c7af","type":"status_pages"}}}}}'
     headers:
       content-type:
       - application/vnd.api+json
@@ -43,7 +43,7 @@ interactions:
       accept:
       - '*/*'
     method: DELETE
-    uri: https://api.datadoghq.com/api/v2/statuspages/daae96b1-2114-4979-8668-2f782fe4a82b/components/dc1f6182-86a0-4f18-a4de-78f99ff1455f
+    uri: https://api.datadoghq.com/api/v2/statuspages/b02801ff-949d-467e-967d-5943c8f1c7af/components/ef964967-c6b6-465a-a260-0468b697036c
   response:
     body:
       string: ''
@@ -57,7 +57,7 @@ interactions:
       accept:
       - '*/*'
     method: DELETE
-    uri: https://api.datadoghq.com/api/v2/statuspages/daae96b1-2114-4979-8668-2f782fe4a82b
+    uri: https://api.datadoghq.com/api/v2/statuspages/b02801ff-949d-467e-967d-5943c8f1c7af
   response:
     body:
       string: ''

tests/v2/cassettes/test_scenarios/test_create_degradation_returns_created_response.frozen

@@ -1 +1 @@
-2026-03-31T18:43:46.834Z
+2026-04-24T14:12:38.944Z

tests/v2/cassettes/test_scenarios/test_create_degradation_returns_created_response.yaml

@@ -1,6 +1,6 @@
 interactions:
 - request:
-    body: '{"data":{"attributes":{"components":[{"components":[{"name":"Login","position":0,"type":"component"},{"name":"Settings","position":1,"type":"component"}],"name":"Application","type":"group"}],"domain_prefix":"5ddb4afc3c8db319","enabled":true,"name":"A
+    body: '{"data":{"attributes":{"components":[{"components":[{"name":"Login","position":0,"type":"component"},{"name":"Settings","position":1,"type":"component"}],"name":"Application","type":"group"}],"domain_prefix":"6fadaccff9a14c1b","name":"A
       Status Page","type":"internal","visualization_type":"bars_and_uptime_percentage"},"type":"status_pages"}}'
     headers:
       accept:
@@ -11,16 +11,16 @@ interactions:
     uri: https://api.datadoghq.com/api/v2/statuspages
   response:
     body:
-      string: '{"data":{"id":"8c7a1055-f55b-49de-a9d0-f6ab38d62627","type":"status_pages","attributes":{"company_logo":null,"components":[{"id":"b8a1027c-f5f9-4fc9-8cb7-94412286e410","name":"Application","type":"group","position":0,"components":[{"id":"e92b23fc-fc4e-4f12-b1a7-66a78f4b950e","name":"Login","type":"component","status":"operational","position":0},{"id":"18cca9eb-d603-4051-806f-18557d6669b7","name":"Settings","type":"component","status":"operational","position":1}]}],"created_at":"2026-03-31T18:43:46.876375Z","custom_domain":null,"custom_domain_enabled":false,"domain_prefix":"5ddb4afc3c8db319","email_header_image":null,"enabled":true,"favicon":null,"modified_at":"2026-03-31T18:43:46.876375Z","name":"A
-        Status Page","page_url":"https://frog.datadoghq.com/status-pages/8c7a1055-f55b-49de-a9d0-f6ab38d62627/view","subscriptions_enabled":false,"type":"internal","visualization_type":"bars_and_uptime_percentage"},"relationships":{"created_by_user":{"data":{"id":"3ad549bf-eba0-11e9-a77a-0705486660d0","type":"users"}},"last_modified_by_user":{"data":{"id":"3ad549bf-eba0-11e9-a77a-0705486660d0","type":"users"}}}}}'
+      string: '{"data":{"id":"7a6eba5d-657a-416e-943f-59102f88c3b5","type":"status_pages","attributes":{"company_logo":null,"components":[{"id":"c72b2d6b-f4fb-4934-a68c-265e4f9991d6","name":"Application","type":"group","position":0,"components":[{"id":"13dfd7ee-e741-41f9-af1a-d40fa4caf459","name":"Login","type":"component","status":"operational","position":0},{"id":"e2cffa19-a102-43e1-ac3c-7b36a7a61f52","name":"Settings","type":"component","status":"operational","position":1}]}],"created_at":"2026-04-24T14:12:39.042853Z","custom_domain":null,"custom_domain_enabled":false,"domain_prefix":"6fadaccff9a14c1b","email_header_image":null,"enabled":false,"favicon":null,"modified_at":"2026-04-24T14:12:39.042853Z","name":"A
+        Status Page","page_url":"https://frog.datadoghq.com/status-pages/7a6eba5d-657a-416e-943f-59102f88c3b5/view","subscriptions_enabled":false,"type":"internal","visualization_type":"bars_and_uptime_percentage"},"relationships":{"created_by_user":{"data":{"id":"3ad549bf-eba0-11e9-a77a-0705486660d0","type":"users"}},"last_modified_by_user":{"data":{"id":"3ad549bf-eba0-11e9-a77a-0705486660d0","type":"users"}}}}}'
     headers:
       content-type:
       - application/vnd.api+json
     status:
       code: 201
       message: Created
 - request:
-    body: '{"data":{"attributes":{"components_affected":[{"id":"e92b23fc-fc4e-4f12-b1a7-66a78f4b950e","status":"major_outage"}],"description":"Our
+    body: '{"data":{"attributes":{"components_affected":[{"id":"13dfd7ee-e741-41f9-af1a-d40fa4caf459","status":"major_outage"}],"description":"Our
       API is experiencing elevated latency. We are investigating the issue.","status":"investigating","title":"Elevated
       API Latency"},"type":"degradations"}}'
     headers:
@@ -29,13 +29,13 @@ interactions:
       content-type:
       - application/json
     method: POST
-    uri: https://api.datadoghq.com/api/v2/statuspages/8c7a1055-f55b-49de-a9d0-f6ab38d62627/degradations
+    uri: https://api.datadoghq.com/api/v2/statuspages/7a6eba5d-657a-416e-943f-59102f88c3b5/degradations
   response:
     body:
-      string: '{"data":{"id":"461d1f73-cfa7-4d35-a7c9-7335243f5d71","type":"degradations","attributes":{"components_affected":[{"id":"e92b23fc-fc4e-4f12-b1a7-66a78f4b950e","name":"Login","status":"major_outage"}],"created_at":"2026-03-31T18:43:47.589302Z","description":"Our
-        API is experiencing elevated latency. We are investigating the issue.","modified_at":"2026-03-31T18:43:47.589302Z","status":"investigating","title":"Elevated
-        API Latency","updates":[{"id":"4917a25f-2e54-43c5-bf9c-58002b97e464","created_at":"2026-03-31T18:43:47.589302Z","modified_at":"2026-03-31T18:43:47.589302Z","started_at":"2026-03-31T18:43:47.589302Z","status":"investigating","description":"Our
-        API is experiencing elevated latency. We are investigating the issue.","components_affected":[{"id":"e92b23fc-fc4e-4f12-b1a7-66a78f4b950e","name":"Login","status":"major_outage"}]}]},"relationships":{"created_by_user":{"data":{"id":"3ad549bf-eba0-11e9-a77a-0705486660d0","type":"users"}},"last_modified_by_user":{"data":{"id":"3ad549bf-eba0-11e9-a77a-0705486660d0","type":"users"}},"status_page":{"data":{"id":"8c7a1055-f55b-49de-a9d0-f6ab38d62627","type":"status_pages"}}}}}'
+      string: '{"data":{"id":"ee2a3955-7bbf-4215-a80e-e989ecd58228","type":"degradations","attributes":{"components_affected":[{"id":"13dfd7ee-e741-41f9-af1a-d40fa4caf459","name":"Login","status":"major_outage"}],"created_at":"2026-04-24T14:12:39.710666Z","description":"Our
+        API is experiencing elevated latency. We are investigating the issue.","modified_at":"2026-04-24T14:12:39.710666Z","status":"investigating","title":"Elevated
+        API Latency","updates":[{"id":"59590192-d12c-468e-8e7e-fe34167ed517","created_at":"2026-04-24T14:12:39.710666Z","modified_at":"2026-04-24T14:12:39.710666Z","started_at":"2026-04-24T14:12:39.710666Z","status":"investigating","description":"Our
+        API is experiencing elevated latency. We are investigating the issue.","components_affected":[{"id":"13dfd7ee-e741-41f9-af1a-d40fa4caf459","name":"Login","status":"major_outage"}]}]},"relationships":{"created_by_user":{"data":{"id":"3ad549bf-eba0-11e9-a77a-0705486660d0","type":"users"}},"last_modified_by_user":{"data":{"id":"3ad549bf-eba0-11e9-a77a-0705486660d0","type":"users"}},"status_page":{"data":{"id":"7a6eba5d-657a-416e-943f-59102f88c3b5","type":"status_pages"}}}}}'
     headers:
       content-type:
       - application/vnd.api+json
@@ -48,7 +48,7 @@ interactions:
       accept:
       - '*/*'
     method: DELETE
-    uri: https://api.datadoghq.com/api/v2/statuspages/8c7a1055-f55b-49de-a9d0-f6ab38d62627/degradations/461d1f73-cfa7-4d35-a7c9-7335243f5d71
+    uri: https://api.datadoghq.com/api/v2/statuspages/7a6eba5d-657a-416e-943f-59102f88c3b5/degradations/ee2a3955-7bbf-4215-a80e-e989ecd58228
   response:
     body:
       string: ''
@@ -62,7 +62,7 @@ interactions:
       accept:
       - '*/*'
     method: DELETE
-    uri: https://api.datadoghq.com/api/v2/statuspages/8c7a1055-f55b-49de-a9d0-f6ab38d62627
+    uri: https://api.datadoghq.com/api/v2/statuspages/7a6eba5d-657a-416e-943f-59102f88c3b5
   response:
     body:
       string: ''

tests/v2/cassettes/test_scenarios/test_create_maintenance_returns_created_response.frozen

@@ -1 +1 @@
-2026-03-31T18:43:48.523Z
+2026-04-24T14:12:40.558Z