Skip to main content
GET
Get a single vulnerability root cause for authorized partner tenants.

Authorizations

Authorization
string
header
required

A machine-client token from POST /v1/auth/client-token, carrying subject_type=machine_client and the pulse.read scope.

Scopes

pulse.read

Path Parameters

rootCauseKey
string
required

The root cause's key: a root_cause_key from List vulnerability root causes.

Query Parameters

tenant_ids
string

Comma-separated tenant ids to read. Every id must be inside the caller's authorized scope, otherwise 403 tenant_out_of_scope. Omit it to read every authorized tenant.

expand
string

Comma-separated optional expansions. tenants adds a per-tenant breakdown to each row; cves (on /assets) narrows the list to assets with at least one open finding and attaches their CVEs. Expansions cost extra reads, so ask for them only when needed.

Response

The root cause across the covered tenants. root_cause is null when none of them is affected.

One vulnerability root cause across the authorized tenants.

root_tenant_id
string<uuid>
required

The top of the caller's authorized scope.

coverage
object[]
required

The tenants the root cause was looked up in.

root_cause
null | object
required

The root cause. Null when none of the covered tenants is affected by it.