Update team hierarchy members endpoint to preview

examples/v2/teams/ListTeamHierarchyMembers.py

@@ -0,0 +1,26 @@
+"""
+Get team hierarchy members returns "OK" response
+"""
+
+from os import environ
+from datadog_api_client import ApiClient, Configuration
+from datadog_api_client.v2.api.teams_api import TeamsApi
+
+# there is a valid "dd_team" in the system
+DD_TEAM_DATA_ID = environ["DD_TEAM_DATA_ID"]
+
+# there is a valid "user" in the system
+USER_DATA_ATTRIBUTES_EMAIL = environ["USER_DATA_ATTRIBUTES_EMAIL"]
+
+configuration = Configuration()
+configuration.access_token = environ["DD_BEARER_TOKEN"]
+configuration.unstable_operations["list_team_hierarchy_members"] = True
+with ApiClient(configuration) as api_client:
+    api_instance = TeamsApi(api_client)
+    response = api_instance.list_team_hierarchy_members(
+        team_id=DD_TEAM_DATA_ID,
+        filter_keyword=USER_DATA_ATTRIBUTES_EMAIL,
+        include="user,team",
+    )
+
+    print(response)

examples/v2/teams/ListTeamHierarchyMembers_1000871040.py

@@ -0,0 +1,25 @@
+"""
+Get team hierarchy members paginates by number and size
+"""
+
+from os import environ
+from datadog_api_client import ApiClient, Configuration
+from datadog_api_client.v2.api.teams_api import TeamsApi
+
+# there is a valid "dd_team" in the system
+DD_TEAM_DATA_ID = environ["DD_TEAM_DATA_ID"]
+
+configuration = Configuration()
+configuration.access_token = environ["DD_BEARER_TOKEN"]
+configuration.unstable_operations["list_team_hierarchy_members"] = True
+with ApiClient(configuration) as api_client:
+    api_instance = TeamsApi(api_client)
+    response = api_instance.list_team_hierarchy_members(
+        team_id=DD_TEAM_DATA_ID,
+        filter_keyword="Example-Team",
+        sort="-is_direct",
+        page_number=1,
+        page_size=1,
+    )
+
+    print(response)

examples/v2/teams/ListTeamHierarchyMembers_2494043793.py

@@ -0,0 +1,22 @@
+"""
+Get team hierarchy members filters names case insensitively
+"""
+
+from os import environ
+from datadog_api_client import ApiClient, Configuration
+from datadog_api_client.v2.api.teams_api import TeamsApi
+
+# there is a valid "dd_team" in the system
+DD_TEAM_DATA_ID = environ["DD_TEAM_DATA_ID"]
+
+configuration = Configuration()
+configuration.access_token = environ["DD_BEARER_TOKEN"]
+configuration.unstable_operations["list_team_hierarchy_members"] = True
+with ApiClient(configuration) as api_client:
+    api_instance = TeamsApi(api_client)
+    response = api_instance.list_team_hierarchy_members(
+        team_id=DD_TEAM_DATA_ID,
+        filter_keyword="hIeRaRcHy MeMbEr",
+    )
+
+    print(response)

examples/v2/teams/ListTeamHierarchyMembers_3103330950.py

@@ -0,0 +1,23 @@
+"""
+Get team hierarchy members returns empty results
+"""
+
+from os import environ
+from datadog_api_client import ApiClient, Configuration
+from datadog_api_client.v2.api.teams_api import TeamsApi
+
+# there is a valid "dd_team" in the system
+DD_TEAM_DATA_ID = environ["DD_TEAM_DATA_ID"]
+
+configuration = Configuration()
+configuration.access_token = environ["DD_BEARER_TOKEN"]
+configuration.unstable_operations["list_team_hierarchy_members"] = True
+with ApiClient(configuration) as api_client:
+    api_instance = TeamsApi(api_client)
+    response = api_instance.list_team_hierarchy_members(
+        team_id=DD_TEAM_DATA_ID,
+        filter_keyword="no-matching-member-Example-Team",
+        include="user,team",
+    )
+
+    print(response)

examples/v2/teams/ListTeamHierarchyMembers_3197180671.py

@@ -0,0 +1,24 @@
+"""
+Get team hierarchy members deduplicates direct and inherited membership
+"""
+
+from os import environ
+from datadog_api_client import ApiClient, Configuration
+from datadog_api_client.v2.api.teams_api import TeamsApi
+
+# there is a valid "dd_team" in the system
+DD_TEAM_DATA_ID = environ["DD_TEAM_DATA_ID"]
+
+configuration = Configuration()
+configuration.access_token = environ["DD_BEARER_TOKEN"]
+configuration.unstable_operations["list_team_hierarchy_members"] = True
+with ApiClient(configuration) as api_client:
+    api_instance = TeamsApi(api_client)
+    response = api_instance.list_team_hierarchy_members(
+        team_id=DD_TEAM_DATA_ID,
+        filter_keyword="Example-Team",
+        include="team",
+        sort="-is_direct,handle",
+    )
+
+    print(response)

examples/v2/teams/ListTeamHierarchyMembers_3330810309.py

@@ -0,0 +1,23 @@
+"""
+Get team hierarchy members includes inherited users with null root membership attributes
+"""
+
+from os import environ
+from datadog_api_client import ApiClient, Configuration
+from datadog_api_client.v2.api.teams_api import TeamsApi
+
+# there is a valid "dd_team" in the system
+DD_TEAM_DATA_ID = environ["DD_TEAM_DATA_ID"]
+
+configuration = Configuration()
+configuration.access_token = environ["DD_BEARER_TOKEN"]
+configuration.unstable_operations["list_team_hierarchy_members"] = True
+with ApiClient(configuration) as api_client:
+    api_instance = TeamsApi(api_client)
+    response = api_instance.list_team_hierarchy_members(
+        team_id=DD_TEAM_DATA_ID,
+        filter_keyword="Example-Team",
+        include="user,team",
+    )
+
+    print(response)

examples/v2/teams/ListTeamHierarchyMembers_3355644561.py

@@ -0,0 +1,24 @@
+"""
+Get team hierarchy members filters direct members
+"""
+
+from os import environ
+from datadog_api_client import ApiClient, Configuration
+from datadog_api_client.v2.api.teams_api import TeamsApi
+
+# there is a valid "dd_team" in the system
+DD_TEAM_DATA_ID = environ["DD_TEAM_DATA_ID"]
+
+configuration = Configuration()
+configuration.access_token = environ["DD_BEARER_TOKEN"]
+configuration.unstable_operations["list_team_hierarchy_members"] = True
+with ApiClient(configuration) as api_client:
+    api_instance = TeamsApi(api_client)
+    response = api_instance.list_team_hierarchy_members(
+        team_id=DD_TEAM_DATA_ID,
+        filter_is_direct_only=True,
+        filter_include_service_accounts=False,
+        filter_keyword="Example-Team",
+    )
+
+    print(response)

examples/v2/teams/ListTeamHierarchyMembers_3685423949.py

@@ -0,0 +1,23 @@
+"""
+Get team hierarchy members sorts inherited members before direct members
+"""
+
+from os import environ
+from datadog_api_client import ApiClient, Configuration
+from datadog_api_client.v2.api.teams_api import TeamsApi
+
+# there is a valid "dd_team" in the system
+DD_TEAM_DATA_ID = environ["DD_TEAM_DATA_ID"]
+
+configuration = Configuration()
+configuration.access_token = environ["DD_BEARER_TOKEN"]
+configuration.unstable_operations["list_team_hierarchy_members"] = True
+with ApiClient(configuration) as api_client:
+    api_instance = TeamsApi(api_client)
+    response = api_instance.list_team_hierarchy_members(
+        team_id=DD_TEAM_DATA_ID,
+        filter_keyword="Example-Team",
+        sort="is_direct,-name",
+    )
+
+    print(response)

examples/v2/teams/ListTeamHierarchyMembers_4182775736.py

@@ -0,0 +1,23 @@
+"""
+Get team hierarchy members returns "OK" response with pagination
+"""
+
+from os import environ
+from datadog_api_client import ApiClient, Configuration
+from datadog_api_client.v2.api.teams_api import TeamsApi
+
+# there is a valid "dd_team" in the system
+DD_TEAM_DATA_ID = environ["DD_TEAM_DATA_ID"]
+
+configuration = Configuration()
+configuration.access_token = environ["DD_BEARER_TOKEN"]
+configuration.unstable_operations["list_team_hierarchy_members"] = True
+with ApiClient(configuration) as api_client:
+    api_instance = TeamsApi(api_client)
+    items = api_instance.list_team_hierarchy_members_with_pagination(
+        team_id=DD_TEAM_DATA_ID,
+        filter_keyword="Example-Team",
+        page_size=1,
+    )
+    for item in items:
+        print(item)

src/datadog_api_client/configuration.py

@@ -881,6 +881,7 @@ def __init__(
                 "v2.update_custom_ruleset": False,
                 "v2.add_member_team": False,
                 "v2.list_member_teams": False,
+                "v2.list_team_hierarchy_members": False,
                 "v2.remove_member_team": False,
                 "v2.create_timeseries_anomaly_investigation": False,
                 "v2.create_web_integration_account": False,