[OMG-478] Added permissions note for the memberships APIs (#3284)

Co-authored-by: ci.datadog-api-spec <[email protected]>

Author: api-clients-generation-pipeline[bot]

.generator/schemas/v2/openapi.yaml

@@ -85658,7 +85658,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
@@ -85711,7 +85717,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
@@ -85752,7 +85764,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

src/main/java/com/datadog/api/client/v2/api/TeamsApi.java

@@ -869,6 +869,12 @@ public CompletableFuture<UserTeamResponse> createTeamMembershipAsync(
   /**
    * Add a user to a team.
    *
+   * <p><strong>Note</strong>: Each team has a setting that determines who is allowed to modify
+   * membership of the team. The <code>user_access_manage</code> permission generally grants access
+   * to modify membership of any team. To get the full picture, see <a
+   * href="https://docs.datadoghq.com/account_management/teams/manage/#team-membership">Team
+   * Membership documentation</a>.
+   *
    * @param teamId None (required)
    * @param body (required)
    * @return ApiResponse&lt;UserTeamResponse&gt;
@@ -1457,6 +1463,12 @@ public CompletableFuture<Void> deleteTeamMembershipAsync(String teamId, String u
   /**
    * Remove a user from a team.
    *
+   * <p><strong>Note</strong>: Each team has a setting that determines who is allowed to modify
+   * membership of the team. The <code>user_access_manage</code> permission generally grants access
+   * to modify membership of any team. To get the full picture, see <a
+   * href="https://docs.datadoghq.com/account_management/teams/manage/#team-membership">Team
+   * Membership documentation</a>.
+   *
    * @param teamId None (required)
    * @param userId None (required)
    * @return ApiResponse&lt;Void&gt;
@@ -4957,6 +4969,12 @@ public CompletableFuture<UserTeamResponse> updateTeamMembershipAsync(
   /**
    * Update a user's membership attributes on a team.
    *
+   * <p><strong>Note</strong>: Each team has a setting that determines who is allowed to modify
+   * membership of the team. The <code>user_access_manage</code> permission generally grants access
+   * to modify membership of any team. To get the full picture, see <a
+   * href="https://docs.datadoghq.com/account_management/teams/manage/#team-membership">Team
+   * Membership documentation</a>.
+   *
    * @param teamId None (required)
    * @param userId None (required)
    * @param body (required)