Vulnerabilities API
The vulnerabilities backend exposes a JSON HTTP API consumed by the UI extension via ArgoCD’s proxy at /extensions/vulnerabilities/.
Authorization
Every data endpoint requires the Argocd-Application-Name header (namespace:name format, set automatically by ArgoCD’s proxy). The backend returns 403 if the header is missing or if the requested namespace is not managed by that Application (its destination namespace plus namespaces in status.resources). The backend needs get on applications.argoproj.io for this lookup; the Helm chart grants it by default. The Application is cached for 10 seconds, so a change to its destination or resources takes up to that long to apply.
Report limits
Reports are read from the Kubernetes API 100 at a time, up to 5000 per request. The vulnerability, config audit and SBOM overviews add "truncated": true when a namespace has more; the field is left out otherwise. A CSV export stops at the same limit. The exposed secrets overview still reads a single page of 500.
Resource filter
The overview endpoints take an optional resources list of workload names. Names that are not valid Kubernetes label values are ignored. If the list is empty or no name in it is valid, the response is empty; only a request without resources returns every report in the namespace.
Endpoints
Get vulnerability reports
GET /api/v1/reports?namespace={ns}&resource={resource}&kind={kind} Get vulnerability reports for container images in a namespace.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
namespace | string | Yes | Kubernetes namespace |
resource | string | No | Filter by resource name |
kind | string | No | Filter by resource kind |
Response:
[
{
"image": "library/nginx",
"tag": "latest",
"registry": "docker.io",
"summary": { "critical": 2, "high": 5, "medium": 10, "low": 3, "unknown": 0 },
"fixable": 4,
"lastScanned": "2026-03-18T10:30:00Z",
"containerName": "app",
"resourceKind": "Deployment",
"resourceName": "app-deployment",
"resourceNamespace": "production",
"reportName": "deployment-app-deployment-3f7c9d2k8",
"vulnerabilities": [
{
"id": "CVE-2021-12345",
"severity": "CRITICAL",
"score": 9.8,
"package": "openssl",
"installedVersion": "1.1.1",
"fixedVersion": "1.1.1k",
"title": "Buffer overflow in OpenSSL",
"primaryLink": "https://nvd.nist.gov/vuln/detail/CVE-2021-12345",
"target": "openssl-1.1.1"
}
]
}
] Vulnerability overview
POST /api/v1/overview Get aggregated vulnerability overview for a namespace.
Request body:
{ "namespace": "production" } Response:
{
"summary": { "critical": 2, "high": 5, "medium": 10, "low": 3, "unknown": 0 },
"fixable": 4,
"images": [ ... ],
"namespace": "production"
} Config audit overview
POST /api/v1/audit/overview Get aggregated config audit findings for a namespace. Returns failed checks only.
Request body:
{ "namespace": "production" } Response:
{
"summary": { "critical": 1, "high": 3, "medium": 5, "low": 2, "unknown": 0 },
"reports": [
{
"resourceKind": "Deployment",
"resourceName": "app-deployment",
"summary": { ... },
"checks": [
{
"checkID": "KSV001",
"title": "Image pull policy must be Always",
"severity": "HIGH",
"category": "Pod Security Standards",
"remediation": "Set imagePullPolicy to Always",
"success": false
}
]
}
],
"namespace": "production"
} Exposed secrets overview
POST /api/v1/secrets/overview Get aggregated exposed secrets findings for a namespace.
Request body:
{ "namespace": "production" } Response:
{
"summary": { "critical": 1, "high": 0, "medium": 2, "low": 0, "unknown": 0 },
"reports": [
{
"image": "library/nginx",
"tag": "latest",
"secrets": [
{
"ruleID": "generic-api-key",
"title": "Generic API Key",
"severity": "CRITICAL",
"category": "Secrets",
"target": "Dockerfile"
}
]
}
],
"namespace": "production"
} SBOM overview
POST /api/v1/sbom/overview Get software bill of materials for a namespace.
Request body:
{ "namespace": "production" } Response:
{
"reports": [
{
"image": "library/nginx",
"tag": "latest",
"components": [
{ "name": "openssl", "version": "1.1.1k", "type": "application", "purl": "pkg:deb/debian/openssl@1.1.1k" }
],
"componentsCount": 45
}
],
"totalComponents": 120,
"namespace": "production"
} Export as CSV
GET /api/v1/export?namespace={ns}&type={type} Export reports as CSV file.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
namespace | string | Yes | Kubernetes namespace |
type | string | Yes | vulnerabilities, audit, secrets, or sbom |
Response: CSV file with Content-Disposition: attachment header. If the report list fails before the first row, the response is a JSON error with status 500 instead.
Error responses
{
"error": "namespace is required"
} | Status | Description |
|---|---|
| 400 | Invalid namespace or missing required parameters |
| 403 | Namespace authorization failed (missing Argocd-Application-Name header or namespace not managed by the Application) |
| 500 | Kubernetes API or parsing error |