Regenerate client from commit a6273f07 of spec repo

Author: ci.datadog-api-spec

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-05-27 17:12:13.841874",
-            "spec_repo_commit": "ed439f7c"
+            "regenerated": "2025-06-02 13:31:14.108910",
+            "spec_repo_commit": "a6273f07"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-05-27 17:12:13.857049",
-            "spec_repo_commit": "ed439f7c"
+            "regenerated": "2025-06-02 13:31:14.145494",
+            "spec_repo_commit": "a6273f07"
         }
     }
 }

.generator/schemas/v2/openapi.yaml

@@ -15123,10 +15123,16 @@ components:
     FindingAttributes:
       description: The JSON:API attributes of the finding.
       properties:
+        datadog_link:
+          $ref: '#/components/schemas/FindingDatadogLink'
+        description:
+          $ref: '#/components/schemas/FindingDescription'
         evaluation:
           $ref: '#/components/schemas/FindingEvaluation'
         evaluation_changed_at:
           $ref: '#/components/schemas/FindingEvaluationChangedAt'
+        external_id:
+          $ref: '#/components/schemas/FindingExternalId'
         mute:
           $ref: '#/components/schemas/FindingMute'
         resource:
@@ -15144,6 +15150,22 @@ components:
         vulnerability_type:
           $ref: '#/components/schemas/FindingVulnerabilityType'
       type: object
+    FindingDatadogLink:
+      description: The Datadog relative link for this finding.
+      example: /security/compliance?panels=cpfinding%7Cevent%7CruleId%3Adef-000-u5t%7CresourceId%3Ae8c9ab7c52ebd7bf2fdb4db641082d7d%7CtabId%3Aoverview
+      type: string
+    FindingDescription:
+      description: The description and remediation steps for this finding.
+      example: '## Remediation
+
+
+        1. In the console, go to **Storage Account**.
+
+        2. For each Storage Account, navigate to **Data Protection**.
+
+        3. Select **Set soft delete enabled** and enter the number of days to retain
+        soft deleted data.'
+      type: string
     FindingEvaluation:
       description: The evaluation of the finding.
       enum:
@@ -15161,6 +15183,10 @@ components:
       format: int64
       minimum: 1
       type: integer
+    FindingExternalId:
+      description: The Cloud based Id for the resource related to the finding.
+      example: arn:aws:s3:::my-example-bucket
+      type: string
     FindingID:
       description: The unique ID for this finding.
       example: ZGVmLTAwcC1pZXJ-aS0wZjhjNjMyZDNmMzRlZTgzNw==
@@ -52695,13 +52721,19 @@ paths:
         the equal sign: `filter[evaluation_changed_at]=>=1678809373257`.\n\nQuery
         parameters must be only among the documented ones and with values of correct
         types. Duplicated query parameters (e.g. `filter[status]=low&filter[status]=info`)
-        are not allowed.\n\n### Response\n\nThe response includes an array of finding
-        objects, pagination metadata, and a count of items that match the query.\n\nEach
-        finding object contains the following:\n\n- The finding ID that can be used
-        in a `GetFinding` request to retrieve the full finding details.\n- Core attributes,
-        including status, evaluation, high-level resource details, muted state, and
-        rule details.\n- `evaluation_changed_at` and `resource_discovery_date` time
-        stamps.\n- An array of associated tags.\n"
+        are not allowed.\n\n### Additional extension fields\n\nAdditional extension
+        fields are available for some findings.\n\nThe data is available when you
+        include the query parameter `?detailed_findings=true` in the request.\n\nThe
+        following fields are available for findings:\n- `external_id`: The resource
+        external ID related to the finding.\n- `description`: The description and
+        remediation steps for the finding.\n- `datadog_link`: The Datadog relative
+        link for the finding.\n\n### Response\n\nThe response includes an array of
+        finding objects, pagination metadata, and a count of items that match the
+        query.\n\nEach finding object contains the following:\n\n- The finding ID
+        that can be used in a `GetFinding` request to retrieve the full finding details.\n-
+        Core attributes, including status, evaluation, high-level resource details,
+        muted state, and rule details.\n- `evaluation_changed_at` and `resource_discovery_date`
+        time stamps.\n- An array of associated tags.\n"
       operationId: ListFindings
       parameters:
       - description: Limit the number of findings returned. Must be <= 1000.
@@ -52804,6 +52836,14 @@ paths:
           items:
             $ref: '#/components/schemas/FindingVulnerabilityType'
           type: array
+      - description: Return additional fields for some findings.
+        example:
+        - true
+        in: query
+        name: detailed_findings
+        required: false
+        schema:
+          type: boolean
       responses:
         '200':
           content:

examples/v2/security-monitoring/ListFindings_2932019633.py

@@ -0,0 +1,16 @@
+"""
+List findings returns "OK" response with details
+"""
+
+from datadog_api_client import ApiClient, Configuration
+from datadog_api_client.v2.api.security_monitoring_api import SecurityMonitoringApi
+
+configuration = Configuration()
+configuration.unstable_operations["list_findings"] = True
+with ApiClient(configuration) as api_client:
+    api_instance = SecurityMonitoringApi(api_client)
+    response = api_instance.list_findings(
+        detailed_findings=True,
+    )
+
+    print(response)

src/datadog_api_client/v2/api/security_monitoring_api.py

@@ -1000,6 +1000,11 @@ def __init__(self, api_client=None):
                     "location": "query",
                     "collection_format": "multi",
                 },
+                "detailed_findings": {
+                    "openapi_types": (bool,),
+                    "attribute": "detailed_findings",
+                    "location": "query",
+                },
             },
             headers_map={
                 "accept": ["application/json"],
@@ -2462,6 +2467,7 @@ def list_findings(
         filter_evaluation: Union[FindingEvaluation, UnsetType] = unset,
         filter_status: Union[FindingStatus, UnsetType] = unset,
         filter_vulnerability_type: Union[List[FindingVulnerabilityType], UnsetType] = unset,
+        detailed_findings: Union[bool, UnsetType] = unset,
     ) -> ListFindingsResponse:
         """List findings.
 
@@ -2487,6 +2493,18 @@ def list_findings(
 
         Query parameters must be only among the documented ones and with values of correct types. Duplicated query parameters (e.g. ``filter[status]=low&filter[status]=info`` ) are not allowed.
 
+        **Additional extension fields**
+
+        Additional extension fields are available for some findings.
+
+        The data is available when you include the query parameter ``?detailed_findings=true`` in the request.
+
+        The following fields are available for findings:
+
+        * ``external_id`` : The resource external ID related to the finding.
+        * ``description`` : The description and remediation steps for the finding.
+        * ``datadog_link`` : The Datadog relative link for the finding.
+
         **Response**
 
         The response includes an array of finding objects, pagination metadata, and a count of items that match the query.
@@ -2524,6 +2542,8 @@ def list_findings(
         :type filter_status: FindingStatus, optional
         :param filter_vulnerability_type: Return findings that match the selected vulnerability types (repeatable).
         :type filter_vulnerability_type: [FindingVulnerabilityType], optional
+        :param detailed_findings: Return additional fields for some findings.
+        :type detailed_findings: bool, optional
         :rtype: ListFindingsResponse
         """
         kwargs: Dict[str, Any] = {}
@@ -2566,6 +2586,9 @@ def list_findings(
         if filter_vulnerability_type is not unset:
             kwargs["filter_vulnerability_type"] = filter_vulnerability_type
 
+        if detailed_findings is not unset:
+            kwargs["detailed_findings"] = detailed_findings
+
         return self._list_findings_endpoint.call_with_http_info(**kwargs)
 
     def list_findings_with_pagination(
@@ -2584,6 +2607,7 @@ def list_findings_with_pagination(
         filter_evaluation: Union[FindingEvaluation, UnsetType] = unset,
         filter_status: Union[FindingStatus, UnsetType] = unset,
         filter_vulnerability_type: Union[List[FindingVulnerabilityType], UnsetType] = unset,
+        detailed_findings: Union[bool, UnsetType] = unset,
     ) -> collections.abc.Iterable[Finding]:
         """List findings.
 
@@ -2615,6 +2639,8 @@ def list_findings_with_pagination(
         :type filter_status: FindingStatus, optional
         :param filter_vulnerability_type: Return findings that match the selected vulnerability types (repeatable).
         :type filter_vulnerability_type: [FindingVulnerabilityType], optional
+        :param detailed_findings: Return additional fields for some findings.
+        :type detailed_findings: bool, optional
 
         :return: A generator of paginated results.
         :rtype: collections.abc.Iterable[Finding]
@@ -2659,6 +2685,9 @@ def list_findings_with_pagination(
         if filter_vulnerability_type is not unset:
             kwargs["filter_vulnerability_type"] = filter_vulnerability_type
 
+        if detailed_findings is not unset:
+            kwargs["detailed_findings"] = detailed_findings
+
         local_page_size = get_attribute_from_path(kwargs, "page_limit", 100)
         endpoint = self._list_findings_endpoint
         set_attribute_from_path(kwargs, "page_limit", local_page_size, endpoint.params_map)

src/datadog_api_client/v2/model/finding_attributes.py

@@ -40,8 +40,11 @@ def openapi_types(_):
         from datadog_api_client.v2.model.finding_vulnerability_type import FindingVulnerabilityType
 
         return {
+            "datadog_link": (str,),
+            "description": (str,),
             "evaluation": (FindingEvaluation,),
             "evaluation_changed_at": (int,),
+            "external_id": (str,),
             "mute": (FindingMute,),
             "resource": (str,),
             "resource_discovery_date": (int,),
@@ -53,8 +56,11 @@ def openapi_types(_):
         }
 
     attribute_map = {
+        "datadog_link": "datadog_link",
+        "description": "description",
         "evaluation": "evaluation",
         "evaluation_changed_at": "evaluation_changed_at",
+        "external_id": "external_id",
         "mute": "mute",
         "resource": "resource",
         "resource_discovery_date": "resource_discovery_date",
@@ -67,8 +73,11 @@ def openapi_types(_):
 
     def __init__(
         self_,
+        datadog_link: Union[str, UnsetType] = unset,
+        description: Union[str, UnsetType] = unset,
         evaluation: Union[FindingEvaluation, UnsetType] = unset,
         evaluation_changed_at: Union[int, UnsetType] = unset,
+        external_id: Union[str, UnsetType] = unset,
         mute: Union[FindingMute, UnsetType] = unset,
         resource: Union[str, UnsetType] = unset,
         resource_discovery_date: Union[int, UnsetType] = unset,
@@ -82,12 +91,21 @@ def __init__(
         """
         The JSON:API attributes of the finding.
 
+        :param datadog_link: The Datadog relative link for this finding.
+        :type datadog_link: str, optional
+
+        :param description: The description and remediation steps for this finding.
+        :type description: str, optional
+
         :param evaluation: The evaluation of the finding.
         :type evaluation: FindingEvaluation, optional
 
         :param evaluation_changed_at: The date on which the evaluation for this finding changed (Unix ms).
         :type evaluation_changed_at: int, optional
 
+        :param external_id: The Cloud based Id for the resource related to the finding.
+        :type external_id: str, optional
+
         :param mute: Information about the mute status of this finding.
         :type mute: FindingMute, optional
 
@@ -112,10 +130,16 @@ def __init__(
         :param vulnerability_type: The vulnerability type of the finding.
         :type vulnerability_type: FindingVulnerabilityType, optional
         """
+        if datadog_link is not unset:
+            kwargs["datadog_link"] = datadog_link
+        if description is not unset:
+            kwargs["description"] = description
         if evaluation is not unset:
             kwargs["evaluation"] = evaluation
         if evaluation_changed_at is not unset:
             kwargs["evaluation_changed_at"] = evaluation_changed_at
+        if external_id is not unset:
+            kwargs["external_id"] = external_id
         if mute is not unset:
             kwargs["mute"] = mute
         if resource is not unset:

tests/v2/cassettes/test_scenarios/test_create_a_monitor_notification_rule_returns_bad_request_response.frozen

@@ -1 +1 @@
-2025-04-10T10:29:43.940Z
+2025-04-03T20:58:02.871Z

tests/v2/cassettes/test_scenarios/test_create_a_monitor_notification_rule_returns_bad_request_response.yaml

@@ -1,6 +1,6 @@
 interactions:
 - request:
-    body: '{"data":{"attributes":{"filter":{"tags":["test:test-create_a_monitor_notification_rule_returns_bad_request_response-1744280983","host:abc"]},"name":"test
+    body: '{"data":{"attributes":{"filter":{"tags":["test:test-create_a_monitor_notification_rule_returns_bad_request_response-1743713882","host:abc"]},"name":"test
       rule","recipients":["@slack-test-channel","@jira-test"]},"type":"monitor-notification-rule"}}'
     headers:
       accept:

tests/v2/cassettes/test_scenarios/test_create_a_monitor_notification_rule_returns_ok_response.frozen

@@ -1 +1 @@
-2025-04-10T10:29:44.273Z
+2025-04-03T20:58:03.005Z

tests/v2/cassettes/test_scenarios/test_create_a_monitor_notification_rule_returns_ok_response.yaml

@@ -1,6 +1,6 @@
 interactions:
 - request:
-    body: '{"data":{"attributes":{"filter":{"tags":["test:test-create_a_monitor_notification_rule_returns_ok_response-1744280984"]},"name":"test
+    body: '{"data":{"attributes":{"filter":{"tags":["test:test-create_a_monitor_notification_rule_returns_ok_response-1743713883"]},"name":"test
       rule","recipients":["slack-test-channel","jira-test"]},"type":"monitor-notification-rule"}}'
     headers:
       accept:
@@ -11,8 +11,8 @@ interactions:
     uri: https://api.datadoghq.com/api/v2/monitor/notification_rule
   response:
     body:
-      string: '{"data":{"type":"monitor-notification-rule","attributes":{"filter":{"tags":["test:test-create_a_monitor_notification_rule_returns_ok_response-1744280984"]},"recipients":["slack-test-channel","jira-test"],"name":"test
-        rule","created_at":"2025-04-10T10:29:44.595607+00:00","modified_at":"1970-01-01T00:00:00+00:00"},"id":"a3323ef6-2a04-4ef9-8de8-cbcff5c3c203","relationships":{"created_by":{"data":{"type":"users","id":"3ad549bf-eba0-11e9-a77a-0705486660d0"}}}},"included":[{"type":"users","id":"3ad549bf-eba0-11e9-a77a-0705486660d0","attributes":{"name":"frog","handle":"[email protected]","created_at":"2019-10-02T08:15:39.795051+00:00","modified_at":"2025-04-07T20:19:46.118466+00:00","email":"[email protected]","icon":"https://secure.gravatar.com/avatar/28a16dfe36e73b60c1d55872cb0f1172?s=48&d=retro","title":null,"verified":true,"service_account":false,"disabled":false,"allowed_login_methods":[],"status":"Active"}}]}
+      string: '{"data":{"type":"monitor-notification-rule","id":"55959a04-463a-4579-8386-8c2ca120aa52","attributes":{"creator_uuid":"3ad549bf-eba0-11e9-a77a-0705486660d0","filter":{"tags":["test:test-create_a_monitor_notification_rule_returns_ok_response-1743713883"]},"created_at":"2025-04-03T20:58:03.137650+00:00","recipients":["slack-test-channel","jira-test"],"name":"test
+        rule","modified_at":"1970-01-01T00:00:00+00:00"}}}
 
         '
     headers:
@@ -27,7 +27,7 @@ interactions:
       accept:
       - '*/*'
     method: DELETE
-    uri: https://api.datadoghq.com/api/v2/monitor/notification_rule/a3323ef6-2a04-4ef9-8de8-cbcff5c3c203
+    uri: https://api.datadoghq.com/api/v2/monitor/notification_rule/55959a04-463a-4579-8386-8c2ca120aa52
   response:
     body:
       string: ''

tests/v2/cassettes/test_scenarios/test_delete_a_monitor_notification_rule_returns_not_found_response.frozen

@@ -1 +1 @@
-2025-04-10T10:29:46.694Z
+2025-04-03T20:58:03.324Z

tests/v2/cassettes/test_scenarios/test_delete_a_monitor_notification_rule_returns_not_found_response.yaml

@@ -8,7 +8,7 @@ interactions:
     uri: https://api.datadoghq.com/api/v2/monitor/notification_rule/00000000-0000-1234-0000-000000000000
   response:
     body:
-      string: '{"errors":["Monitor Notification Rule not found"]}'
+      string: '{"errors":["Monitor notification rule not found"]}'
     headers:
       content-type:
       - application/json

tests/v2/cassettes/test_scenarios/test_delete_a_monitor_notification_rule_returns_ok_response.frozen

@@ -1 +1 @@
-2025-04-10T10:29:47.053Z
+2025-04-03T20:58:03.428Z

tests/v2/cassettes/test_scenarios/test_delete_a_monitor_notification_rule_returns_ok_response.yaml

@@ -1,6 +1,6 @@
 interactions:
 - request:
-    body: '{"data":{"attributes":{"filter":{"tags":["app:test-delete_a_monitor_notification_rule_returns_ok_response-1744280987"]},"name":"test
+    body: '{"data":{"attributes":{"filter":{"tags":["app:test-delete_a_monitor_notification_rule_returns_ok_response-1743713883"]},"name":"test
       rule","recipients":["slack-monitor-app"]},"type":"monitor-notification-rule"}}'
     headers:
       accept:
@@ -11,8 +11,8 @@ interactions:
     uri: https://api.datadoghq.com/api/v2/monitor/notification_rule
   response:
     body:
-      string: '{"data":{"type":"monitor-notification-rule","relationships":{"created_by":{"data":{"type":"users","id":"3ad549bf-eba0-11e9-a77a-0705486660d0"}}},"attributes":{"filter":{"tags":["app:test-delete_a_monitor_notification_rule_returns_ok_response-1744280987"]},"created_at":"2025-04-10T10:29:47.326243+00:00","name":"test
-        rule","recipients":["slack-monitor-app"],"modified_at":"1970-01-01T00:00:00+00:00"},"id":"66e399af-c07e-414d-b4f2-93e196d7b7b7"},"included":[{"type":"users","id":"3ad549bf-eba0-11e9-a77a-0705486660d0","attributes":{"name":"frog","handle":"[email protected]","created_at":"2019-10-02T08:15:39.795051+00:00","modified_at":"2025-04-07T20:19:46.118466+00:00","email":"[email protected]","icon":"https://secure.gravatar.com/avatar/28a16dfe36e73b60c1d55872cb0f1172?s=48&d=retro","title":null,"verified":true,"service_account":false,"disabled":false,"allowed_login_methods":[],"status":"Active"}}]}
+      string: '{"data":{"type":"monitor-notification-rule","id":"cef4c2c7-27b3-4259-9bdd-ec434b4a8a0e","attributes":{"creator_uuid":"3ad549bf-eba0-11e9-a77a-0705486660d0","name":"test
+        rule","created_at":"2025-04-03T20:58:03.555501+00:00","modified_at":"1970-01-01T00:00:00+00:00","filter":{"tags":["app:test-delete_a_monitor_notification_rule_returns_ok_response-1743713883"]},"recipients":["slack-monitor-app"]}}}
 
         '
     headers:
@@ -27,7 +27,7 @@ interactions:
       accept:
       - '*/*'
     method: DELETE
-    uri: https://api.datadoghq.com/api/v2/monitor/notification_rule/66e399af-c07e-414d-b4f2-93e196d7b7b7
+    uri: https://api.datadoghq.com/api/v2/monitor/notification_rule/cef4c2c7-27b3-4259-9bdd-ec434b4a8a0e
   response:
     body:
       string: ''
@@ -43,10 +43,10 @@ interactions:
       accept:
       - '*/*'
     method: DELETE
-    uri: https://api.datadoghq.com/api/v2/monitor/notification_rule/66e399af-c07e-414d-b4f2-93e196d7b7b7
+    uri: https://api.datadoghq.com/api/v2/monitor/notification_rule/cef4c2c7-27b3-4259-9bdd-ec434b4a8a0e
   response:
     body:
-      string: '{"errors":["Monitor Notification Rule not found"]}'
+      string: '{"errors":["Monitor notification rule not found"]}'
     headers:
       content-type:
       - application/json

tests/v2/cassettes/test_scenarios/test_get_a_monitor_notification_rule_returns_not_found_response.frozen

@@ -1 +1 @@
-2025-04-10T10:29:52.213Z
+2025-04-03T20:58:03.884Z