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

Co-authored-by: ci.datadog-api-spec <packages@datadoghq.com>

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

.generated-info

@@ -1,4 +1,4 @@
 {
-  "spec_repo_commit": "df31e44",
-  "generated": "2025-07-28 19:55:56.622"
+  "spec_repo_commit": "dcf594e",
+  "generated": "2025-07-31 09:57:14.491"
 }

.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'

api/datadogV2/api_security_monitoring.go

@@ -3054,6 +3054,7 @@ type ListFindingsOptionalParameters struct {
 	FilterRuleId              *string
 	FilterRuleName            *string
 	FilterResourceType        *string
+	FilterResourceId          *string
 	FilterDiscoveryTimestamp  *string
 	FilterEvaluation          *FindingEvaluation
 	FilterStatus              *FindingStatus
@@ -3121,6 +3122,12 @@ func (r *ListFindingsOptionalParameters) WithFilterResourceType(filterResourceTy
 	return r
 }
 
+// WithFilterResourceId sets the corresponding parameter name and returns the struct.
+func (r *ListFindingsOptionalParameters) WithFilterResourceId(filterResourceId string) *ListFindingsOptionalParameters {
+	r.FilterResourceId = &filterResourceId
+	return r
+}
+
 // WithFilterDiscoveryTimestamp sets the corresponding parameter name and returns the struct.
 func (r *ListFindingsOptionalParameters) WithFilterDiscoveryTimestamp(filterDiscoveryTimestamp string) *ListFindingsOptionalParameters {
 	r.FilterDiscoveryTimestamp = &filterDiscoveryTimestamp
@@ -3184,6 +3191,7 @@ func (r *ListFindingsOptionalParameters) WithDetailedFindings(detailedFindings b
 // - `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
 //
@@ -3256,6 +3264,9 @@ func (a *SecurityMonitoringApi) ListFindings(ctx _context.Context, o ...ListFind
 	if optionalParams.FilterResourceType != nil {
 		localVarQueryParams.Add("filter[resource_type]", datadog.ParameterToString(*optionalParams.FilterResourceType, ""))
 	}
+	if optionalParams.FilterResourceId != nil {
+		localVarQueryParams.Add("filter[@resource_id]", datadog.ParameterToString(*optionalParams.FilterResourceId, ""))
+	}
 	if optionalParams.FilterDiscoveryTimestamp != nil {
 		localVarQueryParams.Add("filter[discovery_timestamp]", datadog.ParameterToString(*optionalParams.FilterDiscoveryTimestamp, ""))
 	}