Document include_scopes query param on GET /api/v2/permissions

.generator/schemas/v2/openapi.yaml

@@ -174662,6 +174662,19 @@ paths:
       description: |-
         Returns a list of all permissions, including name, description, and ID.
       operationId: ListPermissions
+      parameters:
+        - description: |-
+            Set to `true` to return all permissions, including both permissions
+            that can be assigned to user roles and permissions that can only be
+            used as scopes for OAuth clients and scoped credentials. When `false`
+            (default), only permissions that can be assigned to user roles are
+            returned.
+          example: false
+          in: query
+          name: include_scopes
+          required: false
+          schema:
+            type: boolean
       responses:
         "200":
           content:

examples/v2/roles/ListPermissions_1350046915.py

@@ -0,0 +1,15 @@
+"""
+List permissions including scopes returns "OK" response
+"""
+
+from datadog_api_client import ApiClient, Configuration
+from datadog_api_client.v2.api.roles_api import RolesApi
+
+configuration = Configuration()
+with ApiClient(configuration) as api_client:
+    api_instance = RolesApi(api_client)
+    response = api_instance.list_permissions(
+        include_scopes=True,
+    )
+
+    print(response)

src/datadog_api_client/v2/api/roles_api.py

@@ -199,7 +199,13 @@ def __init__(self, api_client=None):
                 "http_method": "GET",
                 "version": "v2",
             },
-            params_map={},
+            params_map={
+                "include_scopes": {
+                    "openapi_types": (bool,),
+                    "attribute": "include_scopes",
+                    "location": "query",
+                },
+            },
             headers_map={
                 "accept": ["application/json"],
             },
@@ -536,14 +542,25 @@ def get_role(
 
     def list_permissions(
         self,
+        *,
+        include_scopes: Union[bool, UnsetType] = unset,
     ) -> PermissionsResponse:
         """List permissions.
 
         Returns a list of all permissions, including name, description, and ID.
 
+        :param include_scopes: Set to ``true`` to return all permissions, including both permissions
+            that can be assigned to user roles and permissions that can only be
+            used as scopes for OAuth clients and scoped credentials. When ``false``
+            (default), only permissions that can be assigned to user roles are
+            returned.
+        :type include_scopes: bool, optional
         :rtype: PermissionsResponse
         """
         kwargs: Dict[str, Any] = {}
+        if include_scopes is not unset:
+            kwargs["include_scopes"] = include_scopes
+
         return self._list_permissions_endpoint.call_with_http_info(**kwargs)
 
     def list_role_permissions(

tests/v2/cassettes/test_scenarios/test_list_permissions_including_scopes_returns_ok_response.frozen

@@ -0,0 +1 @@
+2026-08-05T16:12:34.510Z