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

Co-authored-by: ci.datadog-api-spec <packages@datadoghq.com>

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

api/datadogV2/api_teams.go

@@ -436,6 +436,8 @@ func (a *TeamsApi) CreateTeamLink(ctx _context.Context, teamId string, body Team
 
 // CreateTeamMembership Add a user to a team.
 // 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).
 func (a *TeamsApi) CreateTeamMembership(ctx _context.Context, teamId string, body UserTeamRequest) (UserTeamResponse, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod  = _nethttp.MethodPost
@@ -733,6 +735,8 @@ func (a *TeamsApi) DeleteTeamLink(ctx _context.Context, teamId string, linkId st
 
 // DeleteTeamMembership Remove a user from a team.
 // 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).
 func (a *TeamsApi) DeleteTeamMembership(ctx _context.Context, teamId string, userId string) (*_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod = _nethttp.MethodDelete
@@ -2751,6 +2755,8 @@ func (a *TeamsApi) UpdateTeamLink(ctx _context.Context, teamId string, linkId st
 
 // UpdateTeamMembership Update a user's membership attributes on a team.
 // 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).
 func (a *TeamsApi) UpdateTeamMembership(ctx _context.Context, teamId string, userId string, body UserTeamUpdateRequest) (UserTeamResponse, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod  = _nethttp.MethodPatch