Add deprecation notice for Cloud API (#306)

* Add deprecation notice for Cloud API

* Add deprecation timeline dates

* Apply suggestion from automated review

* Update modules/get-started/pages/whats-new-cloud.adoc

Co-authored-by: Michele Cyran <[email protected]>

---------

Co-authored-by: Michele Cyran <[email protected]>

Author: kbatuigas

modules/get-started/pages/whats-new-cloud.adoc

@@ -9,6 +9,18 @@ This page lists new features added to Redpanda Cloud.
 
 == May 2025
 
+=== Cloud API beta versions: deprecated
+
+The Cloud Control Plane API versions v1beta1 and v1beta2, and Data Plane API versions v1alpha1 and v1alpha2 are deprecated. These Cloud API versions will be removed in a future release and are not recommended for use. 
+
+The deprecation timeline is: 
+
+- Announcement date: May 27, 2025
+- End-of-support date: November 28, 2025
+- Retirement date: May 28, 2026
+
+See xref:manage:api/cloud-api-deprecation-policy.adoc[] for more information.
+
 === Read-only cluster configuration properties
 
 You can now xref:manage:cluster-maintenance/config-cluster.adoc#view-cluster-property-values[view the value of read-only cluster configuration properties] with `rpk cluster config` or with the Cloud API. Available properties are listed in xref:reference:properties/cluster-properties.adoc[Cluster Properties] and xref:reference:properties/object-storage-properties.adoc[Object Storage Properties].

modules/manage/pages/api/cloud-api-overview.adoc

@@ -49,6 +49,19 @@ https://api.redpanda.com/v1/clusters
 
 The current Control Plane API version is *v1*.
 
+[IMPORTANT]
+====
+The Control Plane API versions v1beta1 and v1beta2 are deprecated. v1beta1 and v1beta2 are still available, but they will be removed in a future release and are not recommended for use. 
+
+The deprecation timeline is: 
+
+- Announcement date: May 27, 2025
+- End-of-support date: November 28, 2025
+- Retirement date: May 28, 2026
+
+See xref:manage:api/cloud-api-deprecation-policy.adoc[] for more information.
+====
+
 === Data Plane APIs URL
 
 The Data Plane API base URL is unique to the individual target cluster. It is different for each cluster. When making requests to the Data Plane API endpoints, the request URL is the base URL, plus the API version, plus the resource path. For example:
@@ -60,6 +73,19 @@ https://api-aeb32d9b.cn20bu40d061nvem7sv0.fmc.prd.cloud.redpanda.com/v1/users
 
 The current Data Plane API version is *v1*.
 
+[IMPORTANT]
+====
+The Data Plane API versions v1alpha1 and v1alpha2 are deprecated. v1alpha1 and v1alpha2 are still available, but they will be removed in a future release and are not recommended for use. 
+
+The deprecation timeline is: 
+
+- Announcement date: May 27, 2025
+- End-of-support date: November 28, 2025
+- Retirement date: May 28, 2026
+
+See xref:manage:api/cloud-api-deprecation-policy.adoc[] for more information.
+====
+
 == Pagination
 
 When an endpoint returns a list containing more items than can be returned in a single response, the response object includes a `next_page_token`. You can pass the token value as a parameter in the next request. When the full list has been returned, `next_page_token` is an empty string.

modules/manage/pages/maintenance.adoc

@@ -115,6 +115,15 @@ See also: xref:manage:api/cloud-api-deprecation-policy.adoc[]
 |===
 | Deprecated in | Feature | Details
 
+| May 2025 | Cloud API beta versions a| The Cloud Control Plane API versions v1beta1 and v1beta2, and Data Plane API versions v1alpha1 and v1alpha2 are deprecated. These Cloud API versions will be removed in a future release and are not recommended for use. 
+
+The deprecation timeline is: 
+
+- Announcement date: May 27, 2025
+- End-of-support date: November 28, 2025
+- Retirement date: May 28, 2026
+
+See xref:manage:api/cloud-api-deprecation-policy.adoc[] for more information.
 | March 2025 | Serverless Standard | For a better customer experience, the Serverless Standard and Serverless Pro products merged into a single offering. xref:get-started:cluster-types/serverless.adoc[Serverless clusters] include the higher usage limits, 99.9% SLA, additional regions, and the free trial. 
-| February 2025 | Private Service Connect v1 | The Redpanda xref:networking:gcp-private-service-connect.adoc[GCP Private Service Connect v2] service provides the ability to allow requests from Private Service Connect endpoints to stay within the same availability zone, avoiding additional networking costs. To upgrade, contact https://support.redpanda.com/hc/en-us/requests/new[Redpanda Support^]. 
+| February 2025 | Private Service Connect v1 | The Redpanda xref:networking:gcp-private-service-connect.adoc[GCP Private Service Connect v2] service provides the ability to allow requests from Private Service Connect endpoints to stay within the same availability zone, avoiding additional networking costs. To upgrade, contact https://support.redpanda.com/hc/en-us/requests/new[Redpanda Support^].
 |===