Add Publish and Unpublish API documentation for Status Pages (#3838)

Co-authored-by: ci.datadog-api-spec <packages@datadoghq.com>

Author: api-clients-generation-pipeline[bot]

.generator/schemas/v2/openapi.yaml

@@ -107213,7 +107213,7 @@ paths:
         permissions:
           - status_pages_settings_read
     post:
-      description: Creates a new status page.
+      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."
       operationId: CreateStatusPage
       parameters:
         - description: "Comma-separated list of resources to include. Supported values: created_by_user, last_modified_by_user."
@@ -107428,7 +107428,7 @@ paths:
         permissions:
           - status_pages_settings_read
     patch:
-      description: Updates an existing status page's attributes.
+      description: "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."
       operationId: UpdateStatusPage
       parameters:
         - description: Whether to delete existing subscribers when updating a status page's type.
@@ -108027,6 +108027,66 @@ paths:
         operator: AND
         permissions:
           - status_pages_incident_write
+  /api/v2/statuspages/{page_id}/publish:
+    post:
+      description: Publishes a status page. For pages of type `public`, makes the status page available on the public internet and requires the `status_pages_public_page_publish` permission. For pages of type `internal`, makes the status page available under the `status-pages/$domain_prefix/view` route within the Datadog organization and requires the `status_pages_internal_page_publish` permission. The `status_pages_settings_write` permission is temporarily honored as we migrate publishing functionality from the update status page endpoint to the publish status page endpoint.
+      operationId: PublishStatusPage
+      parameters:
+        - description: The ID of the status page.
+          in: path
+          name: page_id
+          required: true
+          schema:
+            format: uuid
+            type: string
+      responses:
+        "204":
+          description: No Content
+        "429":
+          $ref: "#/components/responses/TooManyRequestsResponse"
+      security:
+        - apiKeyAuth: []
+          appKeyAuth: []
+        - AuthZ: []
+      summary: Publish status page
+      tags:
+        - Status Pages
+      x-permission:
+        operator: OR
+        permissions:
+          - status_pages_settings_write
+          - status_pages_public_page_publish
+          - status_pages_internal_page_publish
+  /api/v2/statuspages/{page_id}/unpublish:
+    post:
+      description: Unpublishes a status page. For pages of type `public`, removes the status page from the public internet and requires the `status_pages_public_page_publish` permission. For pages of type `internal`, removes the `status-pages/$domain_prefix/view` route from the Datadog organization and requires the `status_pages_internal_page_publish` permission. The `status_pages_settings_write` permission is temporarily honored as we migrate unpublishing functionality from the update status page endpoint to the unpublish status page endpoint.
+      operationId: UnpublishStatusPage
+      parameters:
+        - description: The ID of the status page.
+          in: path
+          name: page_id
+          required: true
+          schema:
+            format: uuid
+            type: string
+      responses:
+        "204":
+          description: No Content
+        "429":
+          $ref: "#/components/responses/TooManyRequestsResponse"
+      security:
+        - apiKeyAuth: []
+          appKeyAuth: []
+        - AuthZ: []
+      summary: Unpublish status page
+      tags:
+        - Status Pages
+      x-permission:
+        operator: OR
+        permissions:
+          - status_pages_settings_write
+          - status_pages_public_page_publish
+          - status_pages_internal_page_publish
   /api/v2/synthetics/api-multistep/subtests/{public_id}:
     get:
       description: |-

cassettes/v2/Status-Pages_1054991783/Create-component-returns-Created-response_1368822724/frozen.json

@@ -1 +1 @@
-"2026-02-24T17:00:35.997Z"
+"2026-03-31T18:43:45.443Z"

cassettes/v2/Status-Pages_1054991783/Create-component-returns-Created-response_1368822724/recording.har

@@ -8,7 +8,7 @@
     },
     "entries": [
       {
-        "_id": "311210609114e4265052d34ab4a2e8a2",
+        "_id": "1ab5246f885fabfdaf11742e3e49c704",
         "_order": 0,
         "cache": {},
         "request": {
@@ -26,13 +26,13 @@
               "value": "application/json"
             }
           ],
-          "headersSize": 560,
+          "headersSize": 562,
           "httpVersion": "HTTP/1.1",
           "method": "POST",
           "postData": {
             "mimeType": "application/json",
             "params": [],
-            "text": "{\"data\":{\"attributes\":{\"components\":[{\"components\":[{\"name\":\"Login\",\"position\":0,\"type\":\"component\"},{\"name\":\"Settings\",\"position\":1,\"type\":\"component\"}],\"name\":\"Application\",\"type\":\"group\"}],\"domain_prefix\":\"df531f11f71a2e23\",\"enabled\":true,\"name\":\"A Status Page\",\"type\":\"internal\",\"visualization_type\":\"bars_and_uptime_percentage\"},\"type\":\"status_pages\"}}"
+            "text": "{\"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 Status Page\",\"type\":\"internal\",\"visualization_type\":\"bars_and_uptime_percentage\"},\"type\":\"status_pages\"}}"
           },
           "queryString": [],
           "url": "https://api.datadoghq.com/api/v2/statuspages"
@@ -42,7 +42,7 @@
           "content": {
             "mimeType": "application/vnd.api+json",
             "size": 1116,
-            "text": "{\"data\":{\"id\":\"3483924e-54de-4b7f-9177-56f224f8c6e6\",\"type\":\"status_pages\",\"attributes\":{\"company_logo\":null,\"components\":[{\"id\":\"d03bffa2-720c-4f82-871e-3f1599d38089\",\"name\":\"Application\",\"type\":\"group\",\"position\":0,\"components\":[{\"id\":\"6fe382cb-5309-49bf-b56b-c9921a7d8153\",\"name\":\"Login\",\"type\":\"component\",\"status\":\"operational\",\"position\":0},{\"id\":\"b8a9ac5d-2470-4c43-b90d-817ba996822c\",\"name\":\"Settings\",\"type\":\"component\",\"status\":\"operational\",\"position\":1}]}],\"created_at\":\"2026-02-24T17:00:36.165599Z\",\"custom_domain\":null,\"custom_domain_enabled\":false,\"domain_prefix\":\"df531f11f71a2e23\",\"email_header_image\":null,\"enabled\":true,\"favicon\":null,\"modified_at\":\"2026-02-24T17:00:36.165599Z\",\"name\":\"A Status Page\",\"page_url\":\"https://frog.datadoghq.com/status-pages/3483924e-54de-4b7f-9177-56f224f8c6e6/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\"}}}}}"
+            "text": "{\"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\"}}}}}"
           },
           "cookies": [],
           "headers": [
@@ -57,11 +57,11 @@
           "status": 201,
           "statusText": "Created"
         },
-        "startedDateTime": "2026-02-24T17:00:36.000Z",
-        "time": 624
+        "startedDateTime": "2026-03-31T18:43:45.448Z",
+        "time": 530
       },
       {
-        "_id": "b22511f36f59380bc0ac6c152b614707",
+        "_id": "502c3e7100a9f1d1dd961f393aeea16f",
         "_order": 0,
         "cache": {},
         "request": {
@@ -79,7 +79,7 @@
               "value": "application/json"
             }
           ],
-          "headersSize": 606,
+          "headersSize": 608,
           "httpVersion": "HTTP/1.1",
           "method": "POST",
           "postData": {
@@ -88,14 +88,14 @@
             "text": "{\"data\":{\"attributes\":{\"name\":\"Logs\",\"position\":0,\"type\":\"component\"},\"type\":\"components\"}}"
           },
           "queryString": [],
-          "url": "https://api.datadoghq.com/api/v2/statuspages/3483924e-54de-4b7f-9177-56f224f8c6e6/components"
+          "url": "https://api.datadoghq.com/api/v2/statuspages/daae96b1-2114-4979-8668-2f782fe4a82b/components"
         },
         "response": {
-          "bodySize": 556,
+          "bodySize": 558,
           "content": {
             "mimeType": "application/vnd.api+json",
-            "size": 556,
-            "text": "{\"data\":{\"id\":\"060dba63-7f63-4d0f-9278-aecabc6f9c30\",\"type\":\"components\",\"attributes\":{\"created_at\":\"2026-02-24T17:00:36.79986Z\",\"modified_at\":\"2026-02-24T17:00:36.79986Z\",\"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\":\"3483924e-54de-4b7f-9177-56f224f8c6e6\",\"type\":\"status_pages\"}}}}}"
+            "size": 558,
+            "text": "{\"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\"}}}}}"
           },
           "cookies": [],
           "headers": [
@@ -110,11 +110,11 @@
           "status": 201,
           "statusText": "Created"
         },
-        "startedDateTime": "2026-02-24T17:00:36.634Z",
-        "time": 182
+        "startedDateTime": "2026-03-31T18:43:45.988Z",
+        "time": 128
       },
       {
-        "_id": "36ae825ce73c795043d3cb42af7312d9",
+        "_id": "e52b72692876e1287497ad731a8df83d",
         "_order": 0,
         "cache": {},
         "request": {
@@ -127,11 +127,11 @@
               "value": "*/*"
             }
           ],
-          "headersSize": 580,
+          "headersSize": 582,
           "httpVersion": "HTTP/1.1",
           "method": "DELETE",
           "queryString": [],
-          "url": "https://api.datadoghq.com/api/v2/statuspages/3483924e-54de-4b7f-9177-56f224f8c6e6/components/060dba63-7f63-4d0f-9278-aecabc6f9c30"
+          "url": "https://api.datadoghq.com/api/v2/statuspages/daae96b1-2114-4979-8668-2f782fe4a82b/components/dc1f6182-86a0-4f18-a4de-78f99ff1455f"
         },
         "response": {
           "bodySize": 0,
@@ -147,11 +147,11 @@
           "status": 204,
           "statusText": "No Content"
         },
-        "startedDateTime": "2026-02-24T17:00:36.826Z",
-        "time": 90
+        "startedDateTime": "2026-03-31T18:43:46.127Z",
+        "time": 132
       },
       {
-        "_id": "0e65686eb30a34d27f6be2214bb96ce3",
+        "_id": "4c9860009294c51429ae3f8dca5862b2",
         "_order": 0,
         "cache": {},
         "request": {
@@ -164,11 +164,11 @@
               "value": "*/*"
             }
           ],
-          "headersSize": 533,
+          "headersSize": 535,
           "httpVersion": "HTTP/1.1",
           "method": "DELETE",
           "queryString": [],
-          "url": "https://api.datadoghq.com/api/v2/statuspages/3483924e-54de-4b7f-9177-56f224f8c6e6"
+          "url": "https://api.datadoghq.com/api/v2/statuspages/daae96b1-2114-4979-8668-2f782fe4a82b"
         },
         "response": {
           "bodySize": 0,
@@ -184,8 +184,8 @@
           "status": 204,
           "statusText": "No Content"
         },
-        "startedDateTime": "2026-02-24T17:00:36.921Z",
-        "time": 752
+        "startedDateTime": "2026-03-31T18:43:46.266Z",
+        "time": 556
       }
     ],
     "pages": [],

cassettes/v2/Status-Pages_1054991783/Create-degradation-returns-Created-response_1504205933/frozen.json

@@ -1 +1 @@
-"2026-02-24T17:00:37.682Z"
+"2026-03-31T18:43:46.834Z"