[Zero Trust Devices] Deprecate several endpoints (#21668)

* [Zero Trust Devices] Deprecate several endpoints

* [Zero Trust Devices] Add override_codes to the replacements.

* [Zero Trust Devices] Update EOL date

* [Zero Trust Devices] Address review comments

* [Zero Trust Devices] Update publish_date, remove Deprecation Date

The common practice for this page is to set publish_date to the EOL date, plus EOL and Deprecation dates are used interchangeably.

Author: marcinflare

src/content/release-notes/api-deprecations.yaml

@@ -5,6 +5,36 @@ productLink: "/fundamentals/"
 productArea: Core platform
 productAreaLink: /fundamentals/reference/changelog/platform/
 entries:
+  - publish_date: "2025-11-11"
+    title: "Zero Trust Devices"
+    description: |-
+      End of life date: November 11, 2025
+
+      We are changing the definition of Devices. Devices are going to represent the real-world machines while
+      the relation between Users and Devices will be represented by a new concept - Registrations.
+
+      As a result multiple fields are moving from Devices to Registrations and we are deprecating the endpoints listed below.
+
+      The deprecated endpoints are not supported on accounts with [multi-user mode](/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/windows-multiuser/) enabled.
+
+      Deprecated API:
+
+        * `GET /accounts/{account_id}/devices`
+        * `GET /accounts/{account_id}/devices/{device_id}`
+        * `GET /accounts/{account_id}/devices/{device_id}/override_codes`
+        * `POST /accounts/{account_id}/devices/revoke`
+        * `POST /accounts/{account_id}/devices/unrevoke`
+
+      Replacement:
+
+        * `GET /accounts/{account_id}/devices/physical-devices`
+        * `GET /accounts/{account_id}/devices/physical-devices/{device_id}`
+        * `GET /accounts/{account_id}/devices/registrations`
+        * `GET /accounts/{account_id}/devices/registrations/{registration_id}`
+        * `GET /accounts/{account_id}/devices/registrations/{registration_id}/override_codes`
+        * `POST /accounts/{account_id}/devices/registrations/revoke`
+        * `POST /accounts/{account_id}/devices/registrations/unrevoke`
+
   - publish_date: "2025-03-20"
     title: "Cloudflare Radar: Attack top industry and vertical endpoints"
     description: |-