From 60bd4aae03a6e5978c490cd7d4e52bb70129def6 Mon Sep 17 00:00:00 2001 From: Marcin Biegan Date: Mon, 14 Apr 2025 15:35:14 +0100 Subject: [PATCH 1/5] [Zero Trust Devices] Deprecate several endpoints --- .../release-notes/api-deprecations.yaml | 29 +++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/src/content/release-notes/api-deprecations.yaml b/src/content/release-notes/api-deprecations.yaml index c2be6b6d63ebd3b..c4dd4d60576612e 100644 --- a/src/content/release-notes/api-deprecations.yaml +++ b/src/content/release-notes/api-deprecations.yaml @@ -5,6 +5,35 @@ productLink: "/fundamentals/" productArea: Core platform productAreaLink: /fundamentals/reference/changelog/platform/ entries: + - publish_date: "2025-04-14" + title: "Zero Trust Devices" + description: |- + End of life date: November 25, 2026 + + 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 Device to Registration and we're deprecating the endpoints listed below. + + The deprecated endpoints are not supported on accounts with [multi-user mode](https://developers.cloudflare.com/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/windows-multiuser/#enable-multi-user-mode) 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}` + * `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: |- From 0bcb9aa8efc116d3379efb6905177a81fd540d19 Mon Sep 17 00:00:00 2001 From: Marcin Biegan Date: Mon, 14 Apr 2025 15:48:06 +0100 Subject: [PATCH 2/5] [Zero Trust Devices] Add override_codes to the replacements. --- src/content/release-notes/api-deprecations.yaml | 1 + 1 file changed, 1 insertion(+) diff --git a/src/content/release-notes/api-deprecations.yaml b/src/content/release-notes/api-deprecations.yaml index c4dd4d60576612e..3fa2b939774e623 100644 --- a/src/content/release-notes/api-deprecations.yaml +++ b/src/content/release-notes/api-deprecations.yaml @@ -31,6 +31,7 @@ entries: * `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` From 9e48b68b82059c912b04a373eb26be0ab5a8af21 Mon Sep 17 00:00:00 2001 From: Marcin Biegan Date: Mon, 14 Apr 2025 15:49:30 +0100 Subject: [PATCH 3/5] [Zero Trust Devices] Update EOL date --- src/content/release-notes/api-deprecations.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/release-notes/api-deprecations.yaml b/src/content/release-notes/api-deprecations.yaml index 3fa2b939774e623..27c7be7605bad58 100644 --- a/src/content/release-notes/api-deprecations.yaml +++ b/src/content/release-notes/api-deprecations.yaml @@ -8,7 +8,7 @@ entries: - publish_date: "2025-04-14" title: "Zero Trust Devices" description: |- - End of life date: November 25, 2026 + End of life date: November 25, 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. From ba1723ba5baa5ffc2235f8cab1f82318f9ce12e2 Mon Sep 17 00:00:00 2001 From: Marcin Biegan Date: Mon, 14 Apr 2025 16:44:56 +0100 Subject: [PATCH 4/5] [Zero Trust Devices] Address review comments --- src/content/release-notes/api-deprecations.yaml | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/src/content/release-notes/api-deprecations.yaml b/src/content/release-notes/api-deprecations.yaml index 27c7be7605bad58..e262b42e14e36cf 100644 --- a/src/content/release-notes/api-deprecations.yaml +++ b/src/content/release-notes/api-deprecations.yaml @@ -8,14 +8,16 @@ entries: - publish_date: "2025-04-14" title: "Zero Trust Devices" description: |- - End of life date: November 25, 2025 + Deprecation date: April 14, 2025 + + 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 Device to Registration and we're deprecating the endpoints listed below. + 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](https://developers.cloudflare.com/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/windows-multiuser/#enable-multi-user-mode) enabled. + 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: From df255e4554cf730535c73a9e0bff658f875a21b2 Mon Sep 17 00:00:00 2001 From: Marcin Biegan Date: Mon, 14 Apr 2025 18:39:18 +0100 Subject: [PATCH 5/5] [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. --- src/content/release-notes/api-deprecations.yaml | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/src/content/release-notes/api-deprecations.yaml b/src/content/release-notes/api-deprecations.yaml index e262b42e14e36cf..140a5e3d791f83e 100644 --- a/src/content/release-notes/api-deprecations.yaml +++ b/src/content/release-notes/api-deprecations.yaml @@ -5,11 +5,9 @@ productLink: "/fundamentals/" productArea: Core platform productAreaLink: /fundamentals/reference/changelog/platform/ entries: - - publish_date: "2025-04-14" + - publish_date: "2025-11-11" title: "Zero Trust Devices" description: |- - Deprecation date: April 14, 2025 - End of life date: November 11, 2025 We are changing the definition of Devices. Devices are going to represent the real-world machines while