Add Publish and Unpublish API documentation for Status Pages

.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/features/v2/status_pages/Create-component-returns-Created-response.frozen

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

cassettes/features/v2/status_pages/Create-degradation-returns-Created-response.frozen

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

cassettes/features/v2/status_pages/Create-maintenance-returns-Created-response.frozen

@@ -1 +1 @@
-2026-02-24T17:00:40.396Z
+2026-03-31T18:43:48.523Z