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

.generator/schemas/v2/openapi.yaml

@@ -17098,7 +17098,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
@@ -17157,10 +17156,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
@@ -17181,7 +17176,6 @@ components:
           example: bars_and_uptime_percentage
       required:
         - domain_prefix
-        - enabled
         - name
         - type
         - visualization_type
@@ -127086,7 +127080,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."
@@ -127122,7 +127116,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.java

@@ -37,7 +37,6 @@ public static void main(String[] args) {
                                         .name("Settings")
                                         .type(CreateComponentRequestDataAttributesType.COMPONENT)
                                         .position(1L)))
-                            .enabled(true)
                             .type(CreateStatusPageRequestDataAttributesType.INTERNAL)
                             .visualizationType(
                                 CreateStatusPageRequestDataAttributesVisualizationType

examples/v2/status-pages/PublishStatusPage.java

@@ -10,17 +10,16 @@ public static void main(String[] args) {
     ApiClient defaultClient = ApiClient.getDefaultApiClient();
     StatusPagesApi apiInstance = new StatusPagesApi(defaultClient);
 
-    // there is a valid "unpublished_status_page" in the system
-    UUID UNPUBLISHED_STATUS_PAGE_DATA_ID = null;
+    // there is a valid "status_page" in the system
+    UUID STATUS_PAGE_DATA_ID = null;
     try {
-      UNPUBLISHED_STATUS_PAGE_DATA_ID =
-          UUID.fromString(System.getenv("UNPUBLISHED_STATUS_PAGE_DATA_ID"));
+      STATUS_PAGE_DATA_ID = UUID.fromString(System.getenv("STATUS_PAGE_DATA_ID"));
     } catch (IllegalArgumentException e) {
       System.err.println("Error parsing UUID: " + e.getMessage());
     }
 
     try {
-      apiInstance.publishStatusPage(UNPUBLISHED_STATUS_PAGE_DATA_ID);
+      apiInstance.publishStatusPage(STATUS_PAGE_DATA_ID);
     } catch (ApiException e) {
       System.err.println("Exception when calling StatusPagesApi#publishStatusPage");
       System.err.println("Status code: " + e.getCode());

examples/v2/status-pages/UnpublishStatusPage.java

@@ -10,16 +10,8 @@ public static void main(String[] args) {
     ApiClient defaultClient = ApiClient.getDefaultApiClient();
     StatusPagesApi apiInstance = new StatusPagesApi(defaultClient);
 
-    // there is a valid "status_page" in the system
-    UUID STATUS_PAGE_DATA_ID = null;
     try {
-      STATUS_PAGE_DATA_ID = UUID.fromString(System.getenv("STATUS_PAGE_DATA_ID"));
-    } catch (IllegalArgumentException e) {
-      System.err.println("Error parsing UUID: " + e.getMessage());
-    }
-
-    try {
-      apiInstance.unpublishStatusPage(STATUS_PAGE_DATA_ID);
+      apiInstance.unpublishStatusPage(UUID.fromString("9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d"));
     } catch (ApiException e) {
       System.err.println("Exception when calling StatusPagesApi#unpublishStatusPage");
       System.err.println("Status code: " + e.getCode());

src/main/java/com/datadog/api/client/v2/api/StatusPagesApi.java

@@ -838,9 +838,9 @@ public CompletableFuture<StatusPage> createStatusPageAsync(
   }
 
   /**
-   * Creates a new status page. <strong>Note</strong>: Publishing a status page on creation via the
-   * <code>enabled</code> property will be deprecated. Use the dedicated <a
-   * href="#publish-status-page">publish</a> status page endpoint after creation instead.
+   * Creates a new status page in an unpublished state. Use the dedicated <a
+   * href="#publish-status-page">publish</a> status page endpoint to publish the page after
+   * creation.
    *
    * @param body (required)
    * @param parameters Optional parameters for the request.

src/main/java/com/datadog/api/client/v2/model/CreateStatusPageRequestDataAttributes.java

@@ -25,7 +25,6 @@
   CreateStatusPageRequestDataAttributes.JSON_PROPERTY_COMPONENTS,
   CreateStatusPageRequestDataAttributes.JSON_PROPERTY_DOMAIN_PREFIX,
   CreateStatusPageRequestDataAttributes.JSON_PROPERTY_EMAIL_HEADER_IMAGE,
-  CreateStatusPageRequestDataAttributes.JSON_PROPERTY_ENABLED,
   CreateStatusPageRequestDataAttributes.JSON_PROPERTY_FAVICON,
   CreateStatusPageRequestDataAttributes.JSON_PROPERTY_NAME,
   CreateStatusPageRequestDataAttributes.JSON_PROPERTY_SUBSCRIPTIONS_ENABLED,
@@ -48,9 +47,6 @@ public class CreateStatusPageRequestDataAttributes {
   public static final String JSON_PROPERTY_EMAIL_HEADER_IMAGE = "email_header_image";
   private String emailHeaderImage;
 
-  public static final String JSON_PROPERTY_ENABLED = "enabled";
-  private Boolean enabled;
-
   public static final String JSON_PROPERTY_FAVICON = "favicon";
   private String favicon;
 
@@ -71,14 +67,12 @@ public CreateStatusPageRequestDataAttributes() {}
   @JsonCreator
   public CreateStatusPageRequestDataAttributes(
       @JsonProperty(required = true, value = JSON_PROPERTY_DOMAIN_PREFIX) String domainPrefix,
-      @JsonProperty(required = true, value = JSON_PROPERTY_ENABLED) Boolean enabled,
       @JsonProperty(required = true, value = JSON_PROPERTY_NAME) String name,
       @JsonProperty(required = true, value = JSON_PROPERTY_TYPE)
           CreateStatusPageRequestDataAttributesType type,
       @JsonProperty(required = true, value = JSON_PROPERTY_VISUALIZATION_TYPE)
           CreateStatusPageRequestDataAttributesVisualizationType visualizationType) {
     this.domainPrefix = domainPrefix;
-    this.enabled = enabled;
     this.name = name;
     this.type = type;
     this.unparsed |= !type.isValid();
@@ -185,26 +179,6 @@ public void setEmailHeaderImage(String emailHeaderImage) {
     this.emailHeaderImage = emailHeaderImage;
   }
 
-  public CreateStatusPageRequestDataAttributes enabled(Boolean enabled) {
-    this.enabled = enabled;
-    return this;
-  }
-
-  /**
-   * Whether the status page is enabled.
-   *
-   * @return enabled
-   */
-  @JsonProperty(JSON_PROPERTY_ENABLED)
-  @JsonInclude(value = JsonInclude.Include.ALWAYS)
-  public Boolean getEnabled() {
-    return enabled;
-  }
-
-  public void setEnabled(Boolean enabled) {
-    this.enabled = enabled;
-  }
-
   public CreateStatusPageRequestDataAttributes favicon(String favicon) {
     this.favicon = favicon;
     return this;
@@ -380,7 +354,6 @@ public boolean equals(Object o) {
         && Objects.equals(this.domainPrefix, createStatusPageRequestDataAttributes.domainPrefix)
         && Objects.equals(
             this.emailHeaderImage, createStatusPageRequestDataAttributes.emailHeaderImage)
-        && Objects.equals(this.enabled, createStatusPageRequestDataAttributes.enabled)
         && Objects.equals(this.favicon, createStatusPageRequestDataAttributes.favicon)
         && Objects.equals(this.name, createStatusPageRequestDataAttributes.name)
         && Objects.equals(
@@ -399,7 +372,6 @@ public int hashCode() {
         components,
         domainPrefix,
         emailHeaderImage,
-        enabled,
         favicon,
         name,
         subscriptionsEnabled,
@@ -416,7 +388,6 @@ public String toString() {
     sb.append("    components: ").append(toIndentedString(components)).append("\n");
     sb.append("    domainPrefix: ").append(toIndentedString(domainPrefix)).append("\n");
     sb.append("    emailHeaderImage: ").append(toIndentedString(emailHeaderImage)).append("\n");
-    sb.append("    enabled: ").append(toIndentedString(enabled)).append("\n");
     sb.append("    favicon: ").append(toIndentedString(favicon)).append("\n");
     sb.append("    name: ").append(toIndentedString(name)).append("\n");
     sb.append("    subscriptionsEnabled: ")

src/test/resources/cassettes/features/v2/Create_component_returns_Created_response.freeze

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

src/test/resources/cassettes/features/v2/Create_component_returns_Created_response.json

@@ -3,7 +3,7 @@
     "httpRequest": {
       "body": {
         "type": "JSON",
-        "json": "{\"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\"}}"
+        "json": "{\"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": {},
       "method": "POST",
@@ -12,7 +12,7 @@
       "secure": true
     },
     "httpResponse": {
-      "body": "{\"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\"}}}}}",
+      "body": "{\"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,7 +27,7 @@
     "timeToLive": {
       "unlimited": true
     },
-    "id": "1ab5246f-885f-abfd-af11-742e3e49c704"
+    "id": "2169e74a-23e0-1eb0-840a-99d5b23da99d"
   },
   {
     "httpRequest": {
@@ -37,12 +37,12 @@
       },
       "headers": {},
       "method": "POST",
-      "path": "/api/v2/statuspages/daae96b1-2114-4979-8668-2f782fe4a82b/components",
+      "path": "/api/v2/statuspages/b02801ff-949d-467e-967d-5943c8f1c7af/components",
       "keepAlive": false,
       "secure": true
     },
     "httpResponse": {
-      "body": "{\"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\"}}}}}",
+      "body": "{\"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"
@@ -57,13 +57,13 @@
     "timeToLive": {
       "unlimited": true
     },
-    "id": "502c3e71-00a9-f1d1-dd96-1f393aeea16f"
+    "id": "b6571c89-cd17-a317-2cbb-78a420729004"
   },
   {
     "httpRequest": {
       "headers": {},
       "method": "DELETE",
-      "path": "/api/v2/statuspages/daae96b1-2114-4979-8668-2f782fe4a82b/components/dc1f6182-86a0-4f18-a4de-78f99ff1455f",
+      "path": "/api/v2/statuspages/b02801ff-949d-467e-967d-5943c8f1c7af/components/ef964967-c6b6-465a-a260-0468b697036c",
       "keepAlive": false,
       "secure": true
     },
@@ -78,13 +78,13 @@
     "timeToLive": {
       "unlimited": true
     },
-    "id": "e52b7269-2876-e128-7497-ad731a8df83d"
+    "id": "1693c83a-278f-9bc5-245f-9d74d24d73c6"
   },
   {
     "httpRequest": {
       "headers": {},
       "method": "DELETE",
-      "path": "/api/v2/statuspages/daae96b1-2114-4979-8668-2f782fe4a82b",
+      "path": "/api/v2/statuspages/b02801ff-949d-467e-967d-5943c8f1c7af",
       "keepAlive": false,
       "secure": true
     },
@@ -99,6 +99,6 @@
     "timeToLive": {
       "unlimited": true
     },
-    "id": "4c986000-9294-c514-29ae-3f8dca5862b2"
+    "id": "02788f1b-1883-029b-21af-5df1bba4dff2"
   }
 ]

src/test/resources/cassettes/features/v2/Create_degradation_returns_Created_response.freeze

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