Skip to content

Commit 03077df

Browse files
feat: [DGP-803] update TestAPI spec to include EPSS details (#399)
1 parent 9e32475 commit 03077df

File tree

3 files changed

+64
-2
lines changed

3 files changed

+64
-2
lines changed
Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
2025-07-25T21:02:17Z main 63c97774c0e15d3a9de663dbdefaf32abf417fcb
1+
2025-08-06T20:25:46Z main 529018351ba1cdf55b64e9d84da27199c58a351f

pkg/apiclients/testapi/2024-10-15/spec.yaml

Lines changed: 39 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -954,7 +954,6 @@ components:
954954
severity_threshold:
955955
allOf:
956956
- $ref: '#/components/schemas/Severity'
957-
default: medium
958957
description: Findings of equal or greater severity will fail the test.
959958
suppress_pending_ignores:
960959
default: false
@@ -1559,6 +1558,10 @@ components:
15591558
15601559
This applies to private packages distributed with ecosystem tooling as well
15611560
as those publicly distributed.
1561+
epss_details:
1562+
allOf:
1563+
- $ref: '#/components/schemas/snykvulndb.EpssDetails'
1564+
description: EPSS details - see note on model definition.
15621565
exploit_details:
15631566
allOf:
15641567
- $ref: '#/components/schemas/snykvulndb.ExploitDetails'
@@ -1605,6 +1608,13 @@ components:
16051608
package_name:
16061609
description: Package name.
16071610
type: string
1611+
package_popularity_rank:
1612+
description: |-
1613+
Percentile rank indicating the package's prevalence across Snyk-monitored projects.
1614+
A higher rank signifies the package is used in a larger percentage of projects.
1615+
maximum: 100
1616+
minimum: 0
1617+
type: number
16081618
package_repository_url:
16091619
description: Link to the package repository containing the vulnerable package.
16101620
example: https://repo.maven.apache.org/maven2
@@ -2413,6 +2423,34 @@ components:
24132423
- secondary
24142424
- other
24152425
type: string
2426+
snykvulndb.EpssDetails:
2427+
description: |-
2428+
Exploit Prediction Scoring System (EPSS), which predicts the likelihood (probability) of the vulnerability to be
2429+
exploited, and the percentile of the EPSS of a vulnerability relative to all other vulnerabilities.
2430+
We are using the latest model.
2431+
https://www.first.org/epss/model
2432+
properties:
2433+
model_version:
2434+
description: The version of the EPSS model we use.
2435+
example: v2025.03.14
2436+
type: string
2437+
percentile:
2438+
description: |-
2439+
The percentile of the EPSS of a vulnerability relative to all other vulnerabilities.
2440+
In value range 0 - 1 with 5 fixed digits.
2441+
example: "0.73768"
2442+
type: string
2443+
probability:
2444+
description: |-
2445+
The probability of the vulnerability to be exploited.
2446+
In value range 0 - 1 with 5 fixed digits.
2447+
example: "0.00859"
2448+
type: string
2449+
required:
2450+
- percentile
2451+
- probability
2452+
- model_version
2453+
type: object
24162454
snykvulndb.ExploitDetails:
24172455
description: Details about the exploitability of a vulnerability.
24182456
properties:

pkg/apiclients/testapi/testapi.gen.go

Lines changed: 24 additions & 0 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

0 commit comments

Comments
 (0)