Account Roles API deprecated in favor of Permission Groups API
The Account Roles API is being deprecated and replaced by the Permission Groups API. Users need to migrate to the new API, which has a different response schema with meta objects and scopes instead of the legacy resource-keyed permissions structure.
The Account Roles API is deprecated and is being replaced by the Permission Groups API. An end of life date has not yet been established.
What you need to do
Review the Permission Groups API documentation; the response schema differs from the legacy Roles response.
Highlights
- Integrations migrating to the Permission Groups API must obtain Permission Group IDs from that API and use them in the Account Members API policies request shape. Integrations that persist legacy Role IDs will need to remap their assignments.
- The legacy
Roleresponse includes a top-leveldescriptionand apermissionsobject keyed by resource type with edit/read flags. - The
PermissionGroupresponse replaces those with ametaobject containinglabelandscopes. Individual permissions are not returned as part of the permission group. - The new API supports the API Token authorization scheme. The legacy Email + API Key authorization schema is provided for backwards compatibility.
For more information, refer to API deprecations.
Source: original entry ↗
More from Cloudflare
Follow Cloudflare to get its new changes in your feed and email digest.
Cloudflare One Client for macOS 2026.8.2100.0
GA release for macOS Cloudflare One Client with improved split tunnel handling that no longer briefly blocks traffic during reconnects, support for non-RFC 1918 local IPv4 networks, faster connects with lower memory use, and numerous reliability fixes across DNS, reauthentication, and client stability.
Cloudflare One Client for Windows 2026.8.2100.0
This GA release improves split tunnel reliability, adds support for non-RFC 1918 local networks, optimizes connection performance with faster reconnections and lower memory usage, and includes numerous bug fixes for DNS, registration, and network handling. The client now features a service recovery mechanism that automatically restarts on system unlock and better handles large hosts files without blocking traffic.
Cloudflare One Client for Linux 2026.8.2100.0
New GA release for Linux with improved split tunnel handling that no longer briefly blocks traffic during reconnects, support for non-RFC 1918 local IPv4 networks, faster tunnel reconnections, and lower memory usage. Includes numerous stability and reliability fixes for DNS, reconnection behavior, and crash issues.