[OMG-478] Added permissions clarification to the membership APIs

.generator/schemas/v2/openapi.yaml

@@ -84010,7 +84010,13 @@ paths:
         permissions:
         - teams_read
     post:
-      description: Add a user to a team.
+      description: 'Add a user to a team.
+
+
+        **Note**: Each team has a setting that determines who is allowed to modify
+        membership of the team. The `user_access_manage` permission generally grants
+        access to modify membership of any team. To get the full picture, see [Team
+        Membership documentation](https://docs.datadoghq.com/account_management/teams/manage/#team-membership).'
       operationId: CreateTeamMembership
       parameters:
       - description: None
@@ -84063,7 +84069,13 @@ paths:
         - teams_read
   /api/v2/team/{team_id}/memberships/{user_id}:
     delete:
-      description: Remove a user from a team.
+      description: 'Remove a user from a team.
+
+
+        **Note**: Each team has a setting that determines who is allowed to modify
+        membership of the team. The `user_access_manage` permission generally grants
+        access to modify membership of any team. To get the full picture, see [Team
+        Membership documentation](https://docs.datadoghq.com/account_management/teams/manage/#team-membership).'
       operationId: DeleteTeamMembership
       parameters:
       - description: None
@@ -84104,7 +84116,13 @@ paths:
         permissions:
         - teams_read
     patch:
-      description: Update a user's membership attributes on a team.
+      description: 'Update a user''s membership attributes on a team.
+
+
+        **Note**: Each team has a setting that determines who is allowed to modify
+        membership of the team. The `user_access_manage` permission generally grants
+        access to modify membership of any team. To get the full picture, see [Team
+        Membership documentation](https://docs.datadoghq.com/account_management/teams/manage/#team-membership).'
       operationId: UpdateTeamMembership
       parameters:
       - description: None

features/v2/given.json

@@ -350,7 +350,7 @@
     "parameters": [
       {
         "name": "body",
-        "value": "{\n  \"data\": {\n    \"type\": \"deployment_gate\",\n    \"attributes\": {\n      \"service\": \"my-service\",\n      \"env\": \"production\",\n      \"identifier\": \"my-gate-{{ unique_lower_alnum }}\",\n      \"dry_run\": false\n    }\n  }\n}"
+        "value": "{\n  \"data\": {\n    \"type\": \"deployment_gate\",\n    \"attributes\": {\n      \"service\": \"my-service\",\n      \"env\": \"production\",\n      \"identifier\": \"my-gate\",\n      \"dry_run\": false\n    }\n  }\n}"
       }
     ],
     "step": "there is a valid \"deployment_gate\" in the system",

lib/datadog_api_client/v2/api/teams_api.rb

@@ -326,6 +326,8 @@ def create_team_membership(team_id, body, opts = {})
     #
     # Add a user to a team.
     #
+    # **Note**: Each team has a setting that determines who is allowed to modify membership of the team. The `user_access_manage` permission generally grants access to modify membership of any team. To get the full picture, see [Team Membership documentation](https://docs.datadoghq.com/account_management/teams/manage/#team-membership).
+    #
     # @param team_id [String] None
     # @param body [UserTeamRequest] 
     # @param opts [Hash] the optional parameters
@@ -533,6 +535,8 @@ def delete_team_membership(team_id, user_id, opts = {})
     #
     # Remove a user from a team.
     #
+    # **Note**: Each team has a setting that determines who is allowed to modify membership of the team. The `user_access_manage` permission generally grants access to modify membership of any team. To get the full picture, see [Team Membership documentation](https://docs.datadoghq.com/account_management/teams/manage/#team-membership).
+    #
     # @param team_id [String] None
     # @param user_id [String] None
     # @param opts [Hash] the optional parameters
@@ -1851,6 +1855,8 @@ def update_team_membership(team_id, user_id, body, opts = {})
     #
     # Update a user's membership attributes on a team.
     #
+    # **Note**: Each team has a setting that determines who is allowed to modify membership of the team. The `user_access_manage` permission generally grants access to modify membership of any team. To get the full picture, see [Team Membership documentation](https://docs.datadoghq.com/account_management/teams/manage/#team-membership).
+    #
     # @param team_id [String] None
     # @param user_id [String] None
     # @param body [UserTeamUpdateRequest]