Regenerate client from commit 50be271 of spec repo

Author: ci.datadog-api-spec

.generator/schemas/v2/openapi.yaml

@@ -249124,6 +249124,15 @@ paths:
           schema:
             example: Active
             type: string
+        - description: |-
+            Filter on the exact user handle. This filter also returns Datadog-managed users,
+            which the list otherwise excludes. Defaults to no filtering.
+          in: query
+          name: filter[handle]
+          required: false
+          schema:
+            example: example-handle
+            type: string
       responses:
         "200":
           content:

examples/v2/users/ListUsers_850007038.py

@@ -0,0 +1,20 @@
+"""
+List all users filtered by handle returns "OK" response
+"""
+
+from os import environ
+from datadog_api_client import ApiClient, Configuration
+from datadog_api_client.v2.api.users_api import UsersApi
+
+# there is a valid "user" in the system
+USER_DATA_ATTRIBUTES_HANDLE = environ["USER_DATA_ATTRIBUTES_HANDLE"]
+
+configuration = Configuration()
+configuration.access_token = environ["DD_BEARER_TOKEN"]
+with ApiClient(configuration) as api_client:
+    api_instance = UsersApi(api_client)
+    response = api_instance.list_users(
+        filter_handle=USER_DATA_ATTRIBUTES_HANDLE,
+    )
+
+    print(response)

src/datadog_api_client/v2/api/users_api.py

@@ -298,6 +298,11 @@ def __init__(self, api_client=None):
                     "attribute": "filter[status]",
                     "location": "query",
                 },
+                "filter_handle": {
+                    "openapi_types": (str,),
+                    "attribute": "filter[handle]",
+                    "location": "query",
+                },
             },
             headers_map={
                 "accept": ["application/json"],
@@ -579,6 +584,7 @@ def list_users(
         sort_dir: Union[QuerySortOrder, UnsetType] = unset,
         filter: Union[str, UnsetType] = unset,
         filter_status: Union[str, UnsetType] = unset,
+        filter_handle: Union[str, UnsetType] = unset,
     ) -> UsersResponse:
         """List all users.
 
@@ -602,6 +608,9 @@ def list_users(
             Comma separated list, with possible values ``Active`` , ``Pending`` , and ``Disabled``.
             Defaults to no filtering.
         :type filter_status: str, optional
+        :param filter_handle: Filter on the exact user handle. This filter also returns Datadog-managed users,
+            which the list otherwise excludes. Defaults to no filtering.
+        :type filter_handle: str, optional
         :rtype: UsersResponse
         """
         kwargs: Dict[str, Any] = {}
@@ -623,6 +632,9 @@ def list_users(
         if filter_status is not unset:
             kwargs["filter_status"] = filter_status
 
+        if filter_handle is not unset:
+            kwargs["filter_handle"] = filter_handle
+
         return self._list_users_endpoint.call_with_http_info(**kwargs)
 
     def list_users_with_pagination(
@@ -634,6 +646,7 @@ def list_users_with_pagination(
         sort_dir: Union[QuerySortOrder, UnsetType] = unset,
         filter: Union[str, UnsetType] = unset,
         filter_status: Union[str, UnsetType] = unset,
+        filter_handle: Union[str, UnsetType] = unset,
     ) -> collections.abc.Iterable[User]:
         """List all users.
 
@@ -656,6 +669,9 @@ def list_users_with_pagination(
             Comma separated list, with possible values ``Active`` , ``Pending`` , and ``Disabled``.
             Defaults to no filtering.
         :type filter_status: str, optional
+        :param filter_handle: Filter on the exact user handle. This filter also returns Datadog-managed users,
+            which the list otherwise excludes. Defaults to no filtering.
+        :type filter_handle: str, optional
 
         :return: A generator of paginated results.
         :rtype: collections.abc.Iterable[User]
@@ -679,6 +695,9 @@ def list_users_with_pagination(
         if filter_status is not unset:
             kwargs["filter_status"] = filter_status
 
+        if filter_handle is not unset:
+            kwargs["filter_handle"] = filter_handle
+
         local_page_size = get_attribute_from_path(kwargs, "page_size", 10)
         endpoint = self._list_users_endpoint
         set_attribute_from_path(kwargs, "page_size", local_page_size, endpoint.params_map)

tests/generated-test/test-runner-data/manifest.json

@@ -12614,6 +12614,13 @@
       "scenario": "Get user details returns \"OK\" response",
       "version": "v2"
     },
+    {
+      "feature": "Users",
+      "feature_file": "../../v2/features/users.feature",
+      "file": "v2/users/list-all-users-filtered-by-handle-returns-ok-response.json",
+      "scenario": "List all users filtered by handle returns \"OK\" response",
+      "version": "v2"
+    },
     {
       "feature": "Users",
       "feature_file": "../../v2/features/users.feature",

tests/generated-test/test-runner-data/v2/users/list-all-users-filtered-by-handle-returns-ok-response.json

@@ -0,0 +1,35 @@
+{
+  "api": "Users",
+  "expected_status": 200,
+  "feature": "Users",
+  "id": "v2/Users/List all users filtered by handle returns \"OK\" response",
+  "operation_id": "ListUsers",
+  "request": {
+    "body": null,
+    "content_type": null,
+    "method": "GET",
+    "pagination": false,
+    "parameters": [
+      {
+        "explode": null,
+        "in": "query",
+        "name": "filter[handle]",
+        "required": false,
+        "schema": {
+          "format": null,
+          "ref": null,
+          "type": "string"
+        },
+        "source": {
+          "path": "user.data.attributes.handle",
+          "type": "fixture"
+        },
+        "style": null
+      }
+    ],
+    "path": "/api/v2/users"
+  },
+  "scenario": "List all users filtered by handle returns \"OK\" response",
+  "schema_version": 1,
+  "version": "v2"
+}

tests/v2/features/users.feature

@@ -156,6 +156,16 @@ Feature: Users
     And the response "data.type" is equal to "users"
     And the response "data.attributes.handle" is equal to "{{ unique_lower }}@datadoghq.com"
 
+  @team:ddoghq/org-management
+  Scenario: List all users filtered by handle returns "OK" response
+    Given there is a valid "user" in the system
+    And new "ListUsers" request
+    And request contains "filter[handle]" parameter from "user.data.attributes.handle"
+    When the request is sent
+    Then the response status is 200 OK
+    And the response "meta.page.total_filtered_count" is equal to 1
+    And the response "data[0].id" has the same value as "user.data.id"
+
   @generated @skip @team:ddoghq/org-management
   Scenario: List all users returns "Bad Request" response
     Given new "ListUsers" request