diff --git a/api/v4/source/roles.yaml b/api/v4/source/roles.yaml
index 927afb6bf6ee..70c57d2f77d0 100644
--- a/api/v4/source/roles.yaml
+++ b/api/v4/source/roles.yaml
@@ -100,7 +100,8 @@
 
         ##### Permissions
 
-        `manage_system` permission is required.
+        Must have `sysconsole_write_user_management_permissions` or `manage_system` permission.
+        When updating the role of a system admin, the `manage_system` permission is mandatory.
 
 
         __Minimum server version__: 4.9