Extended List Findings API to expose resource related Private IP Addresses to details (#2586)

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

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

.generated-info

@@ -1,4 +1,4 @@
 {
-  "spec_repo_commit": "df31e44",
-  "generated": "2025-07-28 19:55:46.645"
+  "spec_repo_commit": "dcf594e",
+  "generated": "2025-07-31 09:56:45.381"
 }

.generator/schemas/v2/openapi.yaml

@@ -56012,12 +56012,13 @@ paths:
         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`
+        link for the finding.\n- `ip_addresses`: The list of private IP addresses
+        for the resource related to 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:
@@ -56088,6 +56089,12 @@ paths:
         required: false
         schema:
           type: string
+      - description: Return only findings for the specified resource id.
+        in: query
+        name: filter[@resource_id]
+        required: false
+        schema:
+          type: string
       - description: Return findings that were found on a specified date (Unix ms)
           or date range (using comparison operators).
         example: '>=1678721573794'

features/support/scenarios_model_mapping.ts

@@ -3412,6 +3412,10 @@ export const ScenariosModelMappings: {[key: string]: {[key: string]: any}} = {
             "type": "string",
             "format": "",
             },
+        "filterResourceId": {
+            "type": "string",
+            "format": "",
+            },
         "filterDiscoveryTimestamp": {
             "type": "string",
             "format": "",

packages/datadog-api-client-v2/apis/SecurityMonitoringApi.ts

@@ -1620,6 +1620,7 @@ export class SecurityMonitoringApiRequestFactory extends BaseAPIRequestFactory {
     filterRuleId?: string,
     filterRuleName?: string,
     filterResourceType?: string,
+    filterResourceId?: string,
     filterDiscoveryTimestamp?: string,
     filterEvaluation?: FindingEvaluation,
     filterStatus?: FindingStatus,
@@ -1708,6 +1709,13 @@ export class SecurityMonitoringApiRequestFactory extends BaseAPIRequestFactory {
         ""
       );
     }
+    if (filterResourceId !== undefined) {
+      requestContext.setQueryParam(
+        "filter[@resource_id]",
+        ObjectSerializer.serialize(filterResourceId, "string", ""),
+        ""
+      );
+    }
     if (filterDiscoveryTimestamp !== undefined) {
       requestContext.setQueryParam(
         "filter[discovery_timestamp]",
@@ -7257,6 +7265,11 @@ export interface SecurityMonitoringApiListFindingsRequest {
    * @type string
    */
   filterResourceType?: string;
+  /**
+   * Return only findings for the specified resource id.
+   * @type string
+   */
+  filterResourceId?: string;
   /**
    * Return findings that were found on a specified date (Unix ms) or date range (using comparison operators).
    * @type string
@@ -8656,6 +8669,7 @@ export class SecurityMonitoringApi {
    * - `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.
+   * - `ip_addresses`: The list of private IP addresses for the resource related to the finding.
    *
    * ### Response
    *
@@ -8683,6 +8697,7 @@ export class SecurityMonitoringApi {
       param.filterRuleId,
       param.filterRuleName,
       param.filterResourceType,
+      param.filterResourceId,
       param.filterDiscoveryTimestamp,
       param.filterEvaluation,
       param.filterStatus,
@@ -8722,6 +8737,7 @@ export class SecurityMonitoringApi {
         param.filterRuleId,
         param.filterRuleName,
         param.filterResourceType,
+        param.filterResourceId,
         param.filterDiscoveryTimestamp,
         param.filterEvaluation,
         param.filterStatus,