datadog_api_client 2.45.0 → 2.47.0

data/lib/datadog_api_client/v2/api/teams_api.rb

@@ -36,11 +36,16 @@ module DatadogAPIClient::V2
     # Add a member team.
     # Adds the team given by the `id` in the body as a member team of the super team.
     #
+    # **Note**: This API is deprecated. For creating team hierarchy links, use the team hierarchy links API: `POST /api/v2/team-hierarchy-links`.
+    #
+    # @deprecated This API is deprecated.
+    #
     # @param super_team_id [String] None
     # @param body [AddMemberTeamRequest] 
     # @param opts [Hash] the optional parameters
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
     def add_member_team_with_http_info(super_team_id, body, opts = {})
+      warn "[DEPRECATION] `AddMemberTeam` is deprecated."
       unstable_enabled = @api_client.config.unstable_operations["v2.add_member_team".to_sym]
       if unstable_enabled
         @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.add_member_team")
@@ -102,6 +107,73 @@ module DatadogAPIClient::V2
       return data, status_code, headers
     end
 
+    # Create a team hierarchy link.
+    #
+    # @see #add_team_hierarchy_link_with_http_info
+    def add_team_hierarchy_link(body, opts = {})
+      data, _status_code, _headers = add_team_hierarchy_link_with_http_info(body, opts)
+      data
+    end
+
+    # Create a team hierarchy link.
+    #
+    # Create a new team hierarchy link between a parent team and a sub team.
+    #
+    # @param body [TeamHierarchyLinkCreateRequest] 
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(TeamHierarchyLinkResponse, Integer, Hash)>] TeamHierarchyLinkResponse data, response status code and response headers
+    def add_team_hierarchy_link_with_http_info(body, opts = {})
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: TeamsAPI.add_team_hierarchy_link ...'
+      end
+      # verify the required parameter 'body' is set
+      if @api_client.config.client_side_validation && body.nil?
+        fail ArgumentError, "Missing the required parameter 'body' when calling TeamsAPI.add_team_hierarchy_link"
+      end
+      # resource path
+      local_var_path = '/api/v2/team-hierarchy-links'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(body)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'TeamHierarchyLinkResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
+
+      new_options = opts.merge(
+        :operation => :add_team_hierarchy_link,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Post, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: TeamsAPI#add_team_hierarchy_link\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Create a team.
     #
     # @see #create_team_with_http_info
@@ -170,6 +242,79 @@ module DatadogAPIClient::V2
       return data, status_code, headers
     end
 
+    # Create team connections.
+    #
+    # @see #create_team_connections_with_http_info
+    def create_team_connections(body, opts = {})
+      data, _status_code, _headers = create_team_connections_with_http_info(body, opts)
+      data
+    end
+
+    # Create team connections.
+    #
+    # Create multiple team connections.
+    #
+    # @param body [TeamConnectionCreateRequest] 
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(TeamConnectionsResponse, Integer, Hash)>] TeamConnectionsResponse data, response status code and response headers
+    def create_team_connections_with_http_info(body, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.create_team_connections".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.create_team_connections")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.create_team_connections"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: TeamsAPI.create_team_connections ...'
+      end
+      # verify the required parameter 'body' is set
+      if @api_client.config.client_side_validation && body.nil?
+        fail ArgumentError, "Missing the required parameter 'body' when calling TeamsAPI.create_team_connections"
+      end
+      # resource path
+      local_var_path = '/api/v2/team/connections'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(body)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'TeamConnectionsResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
+
+      new_options = opts.merge(
+        :operation => :create_team_connections,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Post, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: TeamsAPI#create_team_connections\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Create a team link.
     #
     # @see #create_team_link_with_http_info
@@ -254,6 +399,8 @@ module DatadogAPIClient::V2
     #
     # 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
@@ -379,6 +526,79 @@ module DatadogAPIClient::V2
       return data, status_code, headers
     end
 
+    # Delete team connections.
+    #
+    # @see #delete_team_connections_with_http_info
+    def delete_team_connections(body, opts = {})
+      delete_team_connections_with_http_info(body, opts)
+      nil
+    end
+
+    # Delete team connections.
+    #
+    # Delete multiple team connections.
+    #
+    # @param body [TeamConnectionDeleteRequest] 
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def delete_team_connections_with_http_info(body, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.delete_team_connections".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.delete_team_connections")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.delete_team_connections"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: TeamsAPI.delete_team_connections ...'
+      end
+      # verify the required parameter 'body' is set
+      if @api_client.config.client_side_validation && body.nil?
+        fail ArgumentError, "Missing the required parameter 'body' when calling TeamsAPI.delete_team_connections"
+      end
+      # resource path
+      local_var_path = '/api/v2/team/connections'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['*/*'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(body)
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
+
+      new_options = opts.merge(
+        :operation => :delete_team_connections,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Delete, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: TeamsAPI#delete_team_connections\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Remove a team link.
     #
     # @see #delete_team_link_with_http_info
@@ -461,6 +681,8 @@ module DatadogAPIClient::V2
     #
     # 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
@@ -584,6 +806,71 @@ module DatadogAPIClient::V2
       return data, status_code, headers
     end
 
+    # Get a team hierarchy link.
+    #
+    # @see #get_team_hierarchy_link_with_http_info
+    def get_team_hierarchy_link(link_id, opts = {})
+      data, _status_code, _headers = get_team_hierarchy_link_with_http_info(link_id, opts)
+      data
+    end
+
+    # Get a team hierarchy link.
+    #
+    # Get a single team hierarchy link for the given link_id.
+    #
+    # @param link_id [String] The team hierarchy link's identifier
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(TeamHierarchyLinkResponse, Integer, Hash)>] TeamHierarchyLinkResponse data, response status code and response headers
+    def get_team_hierarchy_link_with_http_info(link_id, opts = {})
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: TeamsAPI.get_team_hierarchy_link ...'
+      end
+      # verify the required parameter 'link_id' is set
+      if @api_client.config.client_side_validation && link_id.nil?
+        fail ArgumentError, "Missing the required parameter 'link_id' when calling TeamsAPI.get_team_hierarchy_link"
+      end
+      # resource path
+      local_var_path = '/api/v2/team-hierarchy-links/{link_id}'.sub('{link_id}', CGI.escape(link_id.to_s).gsub('%2F', '/'))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'TeamHierarchyLinkResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
+
+      new_options = opts.merge(
+        :operation => :get_team_hierarchy_link,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Get, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: TeamsAPI#get_team_hierarchy_link\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Get a team link.
     #
     # @see #get_team_link_with_http_info
@@ -883,6 +1170,84 @@ module DatadogAPIClient::V2
       return data, status_code, headers
     end
 
+    # Get team sync configurations.
+    #
+    # @see #get_team_sync_with_http_info
+    def get_team_sync(filter_source, opts = {})
+      data, _status_code, _headers = get_team_sync_with_http_info(filter_source, opts)
+      data
+    end
+
+    # Get team sync configurations.
+    #
+    # Get all team synchronization configurations.
+    # Returns a list of configurations used for linking or provisioning teams with external sources like GitHub.
+    #
+    # @param filter_source [TeamSyncAttributesSource] Filter by the external source platform for team synchronization
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(TeamSyncResponse, Integer, Hash)>] TeamSyncResponse data, response status code and response headers
+    def get_team_sync_with_http_info(filter_source, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.get_team_sync".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.get_team_sync")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.get_team_sync"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: TeamsAPI.get_team_sync ...'
+      end
+      # verify the required parameter 'filter_source' is set
+      if @api_client.config.client_side_validation && filter_source.nil?
+        fail ArgumentError, "Missing the required parameter 'filter_source' when calling TeamsAPI.get_team_sync"
+      end
+      # verify enum value
+      allowable_values = ['github']
+      if @api_client.config.client_side_validation && !allowable_values.include?(filter_source)
+        fail ArgumentError, "invalid value for \"filter_source\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/v2/team/sync'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'filter[source]'] = filter_source
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'TeamSyncResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
+
+      new_options = opts.merge(
+        :operation => :get_team_sync,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Get, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: TeamsAPI#get_team_sync\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Get user memberships.
     #
     # @see #get_user_memberships_with_http_info
@@ -960,6 +1325,11 @@ module DatadogAPIClient::V2
     #
     # Get all member teams.
     #
+    # **Note**: This API is deprecated. For team hierarchy relationships (parent-child
+    # teams), use the team hierarchy links API: `GET /api/v2/team-hierarchy-links`.
+    #
+    # @deprecated This API is deprecated.
+    #
     # @param super_team_id [String] None
     # @param opts [Hash] the optional parameters
     # @option opts [Integer] :page_size Size for a given page. The maximum allowed value is 100.
@@ -967,6 +1337,7 @@ module DatadogAPIClient::V2
     # @option opts [Array<TeamsField>] :fields_team List of fields that need to be fetched.
     # @return [Array<(TeamsResponse, Integer, Hash)>] TeamsResponse data, response status code and response headers
     def list_member_teams_with_http_info(super_team_id, opts = {})
+      warn "[DEPRECATION] `ListMemberTeams` is deprecated."
       unstable_enabled = @api_client.config.unstable_operations["v2.list_member_teams".to_sym]
       if unstable_enabled
         @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.list_member_teams")
@@ -1047,6 +1418,196 @@ module DatadogAPIClient::V2
         end
     end
 
+    # List team connections.
+    #
+    # @see #list_team_connections_with_http_info
+    def list_team_connections(opts = {})
+      data, _status_code, _headers = list_team_connections_with_http_info(opts)
+      data
+    end
+
+    # List team connections.
+    #
+    # Returns all team connections.
+    #
+    # @param opts [Hash] the optional parameters
+    # @option opts [Integer] :page_size Size for a given page. The maximum allowed value is 100.
+    # @option opts [Integer] :page_number Specific page number to return.
+    # @option opts [Array<String>] :filter_sources Filter team connections by external source systems.
+    # @option opts [Array<String>] :filter_team_ids Filter team connections by Datadog team IDs.
+    # @option opts [Array<String>] :filter_connected_team_ids Filter team connections by connected team IDs from external systems.
+    # @option opts [Array<String>] :filter_connection_ids Filter team connections by connection IDs.
+    # @return [Array<(TeamConnectionsResponse, Integer, Hash)>] TeamConnectionsResponse data, response status code and response headers
+    def list_team_connections_with_http_info(opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.list_team_connections".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.list_team_connections")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.list_team_connections"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: TeamsAPI.list_team_connections ...'
+      end
+      # resource path
+      local_var_path = '/api/v2/team/connections'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'page[size]'] = opts[:'page_size'] if !opts[:'page_size'].nil?
+      query_params[:'page[number]'] = opts[:'page_number'] if !opts[:'page_number'].nil?
+      query_params[:'filter[sources]'] = @api_client.build_collection_param(opts[:'filter_sources'], :csv) if !opts[:'filter_sources'].nil?
+      query_params[:'filter[team_ids]'] = @api_client.build_collection_param(opts[:'filter_team_ids'], :csv) if !opts[:'filter_team_ids'].nil?
+      query_params[:'filter[connected_team_ids]'] = @api_client.build_collection_param(opts[:'filter_connected_team_ids'], :csv) if !opts[:'filter_connected_team_ids'].nil?
+      query_params[:'filter[connection_ids]'] = @api_client.build_collection_param(opts[:'filter_connection_ids'], :csv) if !opts[:'filter_connection_ids'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'TeamConnectionsResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
+
+      new_options = opts.merge(
+        :operation => :list_team_connections,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Get, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: TeamsAPI#list_team_connections\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List team connections.
+    #
+    # Provide a paginated version of {#list_team_connections}, returning all items.
+    #
+    # To use it you need to use a block: list_team_connections_with_pagination { |item| p item }
+    #
+    # @yield [TeamConnection] Paginated items
+    def list_team_connections_with_pagination(opts = {})
+        api_version = "V2"
+        page_size = @api_client.get_attribute_from_path(opts, "page_size", 10)
+        @api_client.set_attribute_from_path(api_version, opts, "page_size", Integer, page_size)
+        @api_client.set_attribute_from_path(api_version, opts, "page_number", Integer, 0)
+        while true do
+            response = list_team_connections(opts)
+            @api_client.get_attribute_from_path(response, "data").each { |item| yield(item) }
+            if @api_client.get_attribute_from_path(response, "data").length < page_size
+              break
+            end
+            @api_client.set_attribute_from_path(api_version, opts, "page_number", Integer, @api_client.get_attribute_from_path(opts, "page_number", 0) + 1)
+        end
+    end
+
+    # Get team hierarchy links.
+    #
+    # @see #list_team_hierarchy_links_with_http_info
+    def list_team_hierarchy_links(opts = {})
+      data, _status_code, _headers = list_team_hierarchy_links_with_http_info(opts)
+      data
+    end
+
+    # Get team hierarchy links.
+    #
+    # List all team hierarchy links that match the provided filters.
+    #
+    # @param opts [Hash] the optional parameters
+    # @option opts [Integer] :page_number Specific page number to return.
+    # @option opts [Integer] :page_size Size for a given page. The maximum allowed value is 100.
+    # @option opts [String] :filter_parent_team Filter by parent team ID
+    # @option opts [String] :filter_sub_team Filter by sub team ID
+    # @return [Array<(TeamHierarchyLinksResponse, Integer, Hash)>] TeamHierarchyLinksResponse data, response status code and response headers
+    def list_team_hierarchy_links_with_http_info(opts = {})
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: TeamsAPI.list_team_hierarchy_links ...'
+      end
+      # resource path
+      local_var_path = '/api/v2/team-hierarchy-links'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'page[number]'] = opts[:'page_number'] if !opts[:'page_number'].nil?
+      query_params[:'page[size]'] = opts[:'page_size'] if !opts[:'page_size'].nil?
+      query_params[:'filter[parent_team]'] = opts[:'filter_parent_team'] if !opts[:'filter_parent_team'].nil?
+      query_params[:'filter[sub_team]'] = opts[:'filter_sub_team'] if !opts[:'filter_sub_team'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'TeamHierarchyLinksResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
+
+      new_options = opts.merge(
+        :operation => :list_team_hierarchy_links,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Get, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: TeamsAPI#list_team_hierarchy_links\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get team hierarchy links.
+    #
+    # Provide a paginated version of {#list_team_hierarchy_links}, returning all items.
+    #
+    # To use it you need to use a block: list_team_hierarchy_links_with_pagination { |item| p item }
+    #
+    # @yield [TeamHierarchyLink] Paginated items
+    def list_team_hierarchy_links_with_pagination(opts = {})
+        api_version = "V2"
+        page_size = @api_client.get_attribute_from_path(opts, "page_size", 10)
+        @api_client.set_attribute_from_path(api_version, opts, "page_size", Integer, page_size)
+        @api_client.set_attribute_from_path(api_version, opts, "page_number", Integer, 0)
+        while true do
+            response = list_team_hierarchy_links(opts)
+            @api_client.get_attribute_from_path(response, "data").each { |item| yield(item) }
+            if @api_client.get_attribute_from_path(response, "data").length < page_size
+              break
+            end
+            @api_client.set_attribute_from_path(api_version, opts, "page_number", Integer, @api_client.get_attribute_from_path(opts, "page_number", 0) + 1)
+        end
+    end
+
     # Get all teams.
     #
     # @see #list_teams_with_http_info
@@ -1161,11 +1722,16 @@ module DatadogAPIClient::V2
     #
     # Remove a super team's member team identified by `member_team_id`.
     #
+    # **Note**: This API is deprecated. For deleting team hierarchy links, use the team hierarchy links API: `DELETE /api/v2/team-hierarchy-links/{link_id}`.
+    #
+    # @deprecated This API is deprecated.
+    #
     # @param super_team_id [String] None
     # @param member_team_id [String] None
     # @param opts [Hash] the optional parameters
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
     def remove_member_team_with_http_info(super_team_id, member_team_id, opts = {})
+      warn "[DEPRECATION] `RemoveMemberTeam` is deprecated."
       unstable_enabled = @api_client.config.unstable_operations["v2.remove_member_team".to_sym]
       if unstable_enabled
         @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.remove_member_team")
@@ -1225,6 +1791,71 @@ module DatadogAPIClient::V2
       return data, status_code, headers
     end
 
+    # Remove a team hierarchy link.
+    #
+    # @see #remove_team_hierarchy_link_with_http_info
+    def remove_team_hierarchy_link(link_id, opts = {})
+      remove_team_hierarchy_link_with_http_info(link_id, opts)
+      nil
+    end
+
+    # Remove a team hierarchy link.
+    #
+    # Remove a team hierarchy link by the given link_id.
+    #
+    # @param link_id [String] The team hierarchy link's identifier
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def remove_team_hierarchy_link_with_http_info(link_id, opts = {})
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: TeamsAPI.remove_team_hierarchy_link ...'
+      end
+      # verify the required parameter 'link_id' is set
+      if @api_client.config.client_side_validation && link_id.nil?
+        fail ArgumentError, "Missing the required parameter 'link_id' when calling TeamsAPI.remove_team_hierarchy_link"
+      end
+      # resource path
+      local_var_path = '/api/v2/team-hierarchy-links/{link_id}'.sub('{link_id}', CGI.escape(link_id.to_s).gsub('%2F', '/'))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['*/*'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
+
+      new_options = opts.merge(
+        :operation => :remove_team_hierarchy_link,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Delete, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: TeamsAPI#remove_team_hierarchy_link\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Link Teams with GitHub Teams.
     #
     # @see #sync_teams_with_http_info
@@ -1245,7 +1876,7 @@ module DatadogAPIClient::V2
     # [A GitHub organization must be connected to your Datadog account](https://docs.datadoghq.com/integrations/github/),
     # and the GitHub App integrated with Datadog must have the `Members Read` permission. Matching is performed by comparing the Datadog team handle to the GitHub team slug
     # using a normalized exact match; case is ignored and spaces are removed. No modifications are made
-    # to teams in GitHub. This will not create new Teams in Datadog.
+    # to teams in GitHub. This only creates new teams in Datadog when type is set to `provision`.
     #
     # @param body [TeamSyncRequest] 
     # @param opts [Hash] the optional parameters
@@ -1470,6 +2101,8 @@ module DatadogAPIClient::V2
     #
     # 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]