From 33616ba1668baf44a24738091caa970a66507940 Mon Sep 17 00:00:00 2001
From: Carissa Dean <carissa.dean@snyk.io>
Date: Thu, 8 Aug 2024 11:53:50 +0100
Subject: [PATCH 1/2] docs: rename properties owned by issues team

---
 docs/.gitbook/assets/v1-api-spec.yaml | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/docs/.gitbook/assets/v1-api-spec.yaml b/docs/.gitbook/assets/v1-api-spec.yaml
index bb3571e83d45..63e73b994796 100644
--- a/docs/.gitbook/assets/v1-api-spec.yaml
+++ b/docs/.gitbook/assets/v1-api-spec.yaml
@@ -17745,7 +17745,7 @@ components:
         issues:
           type: array
           items:
-            $ref: '#/components/schemas/issues2'
+            $ref: '#/components/schemas/aggregatedProjectIssue'
           description: An array of identified issues
     Aggregatedprojectissuesfilters:
       title: Aggregatedprojectissuesfilters
@@ -17758,7 +17758,7 @@ components:
           type: boolean
           description: If set to `true`, Include issue's introducedThrough, if set to `false` (by default), it won't. It's for container only projects (Non-IaC projects only)
         filters:
-          $ref: '#/components/schemas/filters1'
+          $ref: '#/components/schemas/aggregatedProjectIssuesfilter'
     Issuepaths:
       title: Issuepaths
       type: object
@@ -17777,7 +17777,7 @@ components:
           description: The total number of results
         links:
           allOf:
-            - $ref: '#/components/schemas/links1'
+            - $ref: '#/components/schemas/issuePathsLinks'
             - description: Onward links from this record
     Projectsnapshots:
       title: Projectsnapshots
@@ -19374,8 +19374,8 @@ components:
 
 
             When you filter by multiple attributes, you will return projects which have been assigned values of both attributes in the filter.
-    filters1:
-      title: filters1
+    aggregatedProjectIssuesfilter:
+      title: aggregatedProjectIssuesFilter
       type: object
       properties:
         severities:
@@ -21029,8 +21029,8 @@ components:
             upgradePath:
               - org.apache.flex.blazeds:blazeds@4.7.3
         licenses: []
-    issues2:
-      title: issues2
+    aggregatedProjectIssue:
+      title: aggregatedProjectIssue
       required:
         - id
         - issueType
@@ -22728,8 +22728,8 @@ components:
           type: string
           description: The URL for the dependency paths that introduce this issue
       description: Onward links from this record (Non-IaC projects only)
-    links1:
-      title: links1
+    issuePathsLinks:
+      title: issuePathsLinks
       type: object
       properties:
         prev:

From f600c89f4ec12e577ab816eb4440a0ff22c8a2f2 Mon Sep 17 00:00:00 2001
From: Carissa Dean <carissa.dean@snyk.io>
Date: Thu, 8 Aug 2024 12:12:17 +0100
Subject: [PATCH 2/2] docs: update cvssScore description

---
 docs/.gitbook/assets/v1-api-spec.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/.gitbook/assets/v1-api-spec.yaml b/docs/.gitbook/assets/v1-api-spec.yaml
index 63e73b994796..ca67bb95d818 100644
--- a/docs/.gitbook/assets/v1-api-spec.yaml
+++ b/docs/.gitbook/assets/v1-api-spec.yaml
@@ -20785,7 +20785,7 @@ components:
           example: CVSS:3.0/AV:N/AC:H/PR:N/UI:N/S:U/C:N/I:N/A:L
         cvssScore:
           type: number
-          description: The CVSS score that results from running the CVSSv3 string (Non-IaC projects only)
+          description: The CVSS score that results from running the vector from `severities` with the highest CVSS version available.
           example: 3.7
         severities:
           type: array