Playground

Playground

Vulnerability

/api/v1/vulnerabilities

A known weakness on an asset, often tied to a CVE.

listgetcreateupdateresolve

Schema

FieldTypeNotes
id*uuidServer-assigned ULID with type prefix (e.g. per_…).
tenant_id*stringTenant scope — auto-stamped from the caller's JWT.
app_idstringApp scope. Stamped ONLY when the caller's JWT was minted for a specific Application (integration API keys). Absent for human-user sessions. Filters reads when present.
created_at*date-timeServer stamp.
updated_at*date-timeServer stamp; updated on every patch.
created_byuuidPerson id from the caller's JWT (sub).
updated_byuuidPerson id from the last writer's JWT (sub).
sourcestringProvenance tag — defaults to 'edm'.
source_typeenumfrontend | backend | server | system | apiWhere the write originated. Defaults to 'api'.
is_deletedbooleanSoft-delete flag. Excluded from default list queries.
deleted_atdate-timeStamped when soft-deleted; null otherwise.
deleted_byuuidPerson id who soft-deleted; null otherwise.
schema_versionnumberDocument schema version. Bumped on incompatible writes.
cve_idstringCommon Vulnerabilities and Exposures identifier. Null for vulnerabilities that do not have an assigned CVE (e.g. misconfigurations, proprietary scanner findings
titlestringShort, descriptive title summarizing the vulnerability.
descriptionstringDetailed technical description of the vulnerability, including attack vector, prerequisites, and potential impact.
severitystringSeverity classification of this vulnerability. Typically aligned with CVSS severity bands.
cvss_scorenumberCVSS base score (0.0 to 10.0). Null when no CVSS score is available.
cvss_vectorstringCVSS vector string describing the vulnerability characteristics (e.g. CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H).
affected_asset_iduuidUUID of the asset affected by this vulnerability. The asset type is indicated by affectedAssetType.
affected_asset_typestringDiscriminator indicating which entity type affectedAssetId refers to: a TechnologyAsset, PhysicalAsset, or CloudResource.
statusstringCurrent remediation status. 'accepted_risk' requires documented justification and periodic review. 'false_positive' removes the item from active tracking.
discovered_atdate-timeISO 8601 timestamp when this vulnerability was first discovered by the scanning tool or reported.
remediated_atdate-timeISO 8601 timestamp when the vulnerability was confirmed as remediated. Set by the platform or manually by a security engineer.
due_datedate-timeRemediation deadline based on severity SLA policy. Critical vulnerabilities typically have a 7-day SLA, high a 30-day SLA.
assigned_touuidUUID of the Person responsible for remediating this vulnerability.
sourcestringName of the scanner or tool that discovered this vulnerability (e.g. Tenable).

API

client.vulnerabilities.*
Loading manifest…