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

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

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

datadog_api_client.v2.api.html

@@ -14699,6 +14699,7 @@ <h2 id="submodules">Submodules<a class="headerlink" href="#submodules" title="Li
 <span class="sig-name descname"><span class="pre">create_team_membership</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">team_id</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">body</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="datadog_api_client.v2.model.html#datadog_api_client.v2.model.user_team_request.UserTeamRequest" title="datadog_api_client.v2.model.user_team_request.UserTeamRequest"><span class="pre">UserTeamRequest</span></a></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">→</span> <span class="sig-return-typehint"><a class="reference internal" href="datadog_api_client.v2.model.html#datadog_api_client.v2.model.user_team_response.UserTeamResponse" title="datadog_api_client.v2.model.user_team_response.UserTeamResponse"><span class="pre">UserTeamResponse</span></a></span></span><a class="headerlink" href="#datadog_api_client.v2.api.teams_api.TeamsApi.create_team_membership" title="Link to this definition">¶</a></dt>
 <dd><p>Add a user to a team.</p>
 <p>Add a user to a team.</p>
+<p><strong>Note</strong> : Each team has a setting that determines who is allowed to modify membership of the team. The <code class="docutils literal notranslate"><span class="pre">user_access_manage</span></code> permission generally grants access to modify membership of any team. To get the full picture, see <a class="reference external" href="https://docs.datadoghq.com/account_management/teams/manage/#team-membership">Team Membership documentation</a>.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
 <dd class="field-odd"><p><strong>team_id</strong> (<em>str</em>) – None</p>
@@ -14755,6 +14756,7 @@ <h2 id="submodules">Submodules<a class="headerlink" href="#submodules" title="Li
 <span class="sig-name descname"><span class="pre">delete_team_membership</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">team_id</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">user_id</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">→</span> <span class="sig-return-typehint"><span class="pre">None</span></span></span><a class="headerlink" href="#datadog_api_client.v2.api.teams_api.TeamsApi.delete_team_membership" title="Link to this definition">¶</a></dt>
 <dd><p>Remove a user from a team.</p>
 <p>Remove a user from a team.</p>
+<p><strong>Note</strong> : Each team has a setting that determines who is allowed to modify membership of the team. The <code class="docutils literal notranslate"><span class="pre">user_access_manage</span></code> permission generally grants access to modify membership of any team. To get the full picture, see <a class="reference external" href="https://docs.datadoghq.com/account_management/teams/manage/#team-membership">Team Membership documentation</a>.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
 <dd class="field-odd"><ul class="simple">
@@ -15177,6 +15179,7 @@ <h2 id="submodules">Submodules<a class="headerlink" href="#submodules" title="Li
 <span class="sig-name descname"><span class="pre">update_team_membership</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">team_id</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">user_id</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">body</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference internal" href="datadog_api_client.v2.model.html#datadog_api_client.v2.model.user_team_update_request.UserTeamUpdateRequest" title="datadog_api_client.v2.model.user_team_update_request.UserTeamUpdateRequest"><span class="pre">UserTeamUpdateRequest</span></a></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">→</span> <span class="sig-return-typehint"><a class="reference internal" href="datadog_api_client.v2.model.html#datadog_api_client.v2.model.user_team_response.UserTeamResponse" title="datadog_api_client.v2.model.user_team_response.UserTeamResponse"><span class="pre">UserTeamResponse</span></a></span></span><a class="headerlink" href="#datadog_api_client.v2.api.teams_api.TeamsApi.update_team_membership" title="Link to this definition">¶</a></dt>
 <dd><p>Update a user’s membership attributes on a team.</p>
 <p>Update a user’s membership attributes on a team.</p>
+<p><strong>Note</strong> : Each team has a setting that determines who is allowed to modify membership of the team. The <code class="docutils literal notranslate"><span class="pre">user_access_manage</span></code> permission generally grants access to modify membership of any team. To get the full picture, see <a class="reference external" href="https://docs.datadoghq.com/account_management/teams/manage/#team-membership">Team Membership documentation</a>.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
 <dd class="field-odd"><ul class="simple">