[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

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

@@ -714,6 +714,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;
@@ -1154,6 +1160,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;
@@ -4325,6 +4337,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)

src/test/resources/com/datadog/api/client/v2/api/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",