customers

List customers with per-instance CVE exposure.

Changed on

Return a paginated, customer-centric view of CVE exposure. Customers are first selected when an instance's latest reported downstream release has a matching release-image CVE posture. All instances for selected customers are then returned with per-instance CVE counts sourced from SDK-reported running images or uploaded support bundles. Each customer's top-level CVE counts come from its selected worst instance (null when no instance has data), preserving a real instance's posture instead of synthesizing counts across mixed releases. Reporting instances also include the resolved and introduced CVE counts for upgrading supported Helm and Embedded Cluster instances to the latest release currently available on their reported channel when both releases have complete scan data. Each customer includes the recommendation with the highest-severity reduction. Airgap instances without SDK reporting are returned only when another instance selects their customer; they carry the license channel's latest-release CVE posture as context. The severity filter accepts a set (repeatable and/or comma-separated) and keeps customers whose selected worst instance has at least one CVE in any selected severity; customers without CVE data are excluded while a severity filter is active. Counts in the response always cover all four severities. With includeSnapshot=true, both the customer page and an unfiltered snapshot are derived from the authorized fleet's hydrated runtime rows. The snapshot reports the total authorized app-customer population, the number impacted by critical or high CVEs, and active instances with critical CVEs by reported channel release without a second customer-impact request. Requires the Security Center team feature; teams without it receive 403.

Required RBAC Policy: kots/app/[:appid]/license/[:licenseid]/read

get/app/{app_id}/security/customer-impact/customers

Request

  • Base URL
    https://api.replicated.com/vendor/v3
  • URL
    https://api.replicated.com/vendor/v3/app/{app_id}/security/customer-impact/customers
  • Auth
    API key in header Authorization

Path parameters

app_idstring required

App identifier

Query parameters

pageSizeinteger

Page size

currentPageinteger

Current page

searchstring

Customer search term, resolved through the same OpenSearch-backed engine as POST /customers/search and supporting its exact query syntax: a bare term is a fuzzy/prefix name match; name:, type:, channels.name:, customId:, email:, and airgap: prefixes target specific fields.

severitystring[]

One or more severities (critical, high, medium, low) to filter customers by; repeatable and/or comma-separated. A customer is included when its selected worst instance has at least one finding in any selected severity. Empty means no filtering.

includeUnfixableboolean

Include unfixable CVEs in counts (default false)

includeSnapshotboolean

Include the unfiltered fleet-wide customer-impact snapshot and derive the returned customer page from that same authorized population. Snapshot requests cannot be combined with search or severity filters.

sortBystring

Sort order: customerName, criticalCVEs, totalCVEs, or instanceCount (default criticalCVEs)

Response

ListSecurityCustomerImpactResponse contains the customer-impact list

totalCustomersinteger

Changes