{"command":{"effect":"read","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Lists all security finding instances for a given security finding.","properties":{"path":{"type":"object","properties":{"account_id":{"type":"string","examples":["46148281d8a93d002ef242d8b0d5f9f6"],"description":"Cloudflare account ID for the user making the request."},"finding_id":{"type":"string","format":"byte","description":"The `id` of a finding, as returned in each item of the List posture findings response.\nIt is a base64-encoded identifier."}},"required":["account_id","finding_id"],"additionalProperties":false},"query":{"type":"object","properties":{"archived":{"type":"boolean","description":"Archived"},"cursor":{"type":"string","description":"A cursor for pagination. Obtained from the `result_info.cursor` field of a previous response."},"direction":{"type":"string","enum":["asc","desc"],"description":"Direction to order results."},"max_affliction_date":{"type":"string","format":"date-time","description":"Filter to view findings that occurred on or before the affliction date. Can be a date-time in ISO 8601 format or an epoch timestamp."},"min_affliction_date":{"type":"string","format":"date-time","description":"Filter to view findings that occurred on or after the affliction date. Can be a date-time in ISO 8601 format or an epoch timestamp."},"order":{"type":"string","enum":["affliction_date","asset.name","remediation.status"],"description":"Which field to use when ordering the Finding's instances.\nWhen ordering by 'remediation.status', only the most recent non-stale remediation job is considered. Stale jobs (created before the instance's affliction_date) are treated as having no status for ordering purposes."},"page":{"type":"integer","description":"A page number within the paginated result set."},"per_page":{"type":"integer","description":"Number of results to return per page."},"search":{"type":"string","description":"A search term."},"remediation_statuses":{"type":"array","items":{"enum":["none","pending","processing","validating","completed","failed"],"type":"string"},"examples":[["pending","completed","none"]],"description":"Filter finding instances by most recent remediation job status. Supports multiple comma-separated values.\nUse 'none' to filter instances with no remediation jobs or instances where the most recent job is stale.\nNote: Stale jobs (created before the instance's affliction_date) are ignored for filtering purposes, but are still included in the 'remediations' array with stale=true."},"finding_instance_ids":{"type":"array","items":{"format":"uuid","type":"string"},"examples":[["c416bc38-75db-425f-ae25-c37b5df5c37f","b555bc38-75db-425f-ae25-c37b5df5c37f"]],"description":"Filter finding instances by an array of finding instance IDs. Supports multiple comma-separated values."},"asset_ids":{"type":"array","items":{"format":"uuid","type":"string"},"examples":[["c416bc38-75db-425f-ae25-c37b5df5c37f","qw45mm66-75db-425f-ae25-c37b5df5c37f"]],"description":"Filter finding instances by an array of asset IDs. Supports multiple comma-separated values."}},"required":[],"additionalProperties":false}},"required":["path"],"additionalProperties":false},"name":"List instances of a finding","id":"cloudflare.listfindinginstances","example":{"path":{"account_id":"46148281d8a93d002ef242d8b0d5f9f6","finding_id":"aGVsbG8="}},"maxRequests":1,"summary":false}}