Chapter 69. Vulnerability Request Service

69.1.1. ApproveVulnerabilityRequest

POST /v1/cve/requests/{id}/approve

ApproveVulnRequest approve a vulnerability request. If it is an unwatch vulnerability request then the associated vulnerabilities are not watched in workflows such as policy detection, risk, etc.

69.1.1.1. Description

69.1.1.2. Parameters

69.1.1.2.1. Path Parameters

Name	Description	Required	Default	Pattern
id		X	null

69.1.1.2.2. Body Parameter

Name	Description	Required	Default	Pattern
body	VulnerabilityRequestServiceApproveVulnerabilityRequestBody	X

69.1.1.3. Return Type

V1ApproveVulnRequestResponse

69.1.1.4. Content Type

application/json

69.1.1.5. Responses

Table 69.1. HTTP Response Codes
Code	Message	Datatype
200	A successful response.	V1ApproveVulnRequestResponse
0	An unexpected error response.	GooglerpcStatus

69.1.1.6. Samples

69.1.2. DeferVulnerability

POST /v1/cve/requests/defer

DeferVulnerability starts the deferral process for the specified vulnerability.

69.1.2.1. Description

69.1.2.2. Parameters

69.1.2.2.1. Body Parameter

Name	Description	Required	Default	Pattern
body	V1DeferVulnRequest	X

69.1.2.3. Return Type

V1DeferVulnResponse

69.1.2.4. Content Type

application/json

69.1.2.5. Responses

Table 69.2. HTTP Response Codes
Code	Message	Datatype
200	A successful response.	V1DeferVulnResponse
0	An unexpected error response.	GooglerpcStatus

69.1.2.6. Samples

69.1.3. DeleteVulnerabilityRequest

DELETE /v1/cve/requests/{id}

DeleteVulnerabilityRequest deletes a vulnerability request.

69.1.3.1. Description

69.1.3.2. Parameters

69.1.3.2.1. Path Parameters

Name	Description	Required	Default	Pattern
id		X	null

69.1.3.3. Return Type

Object

69.1.3.4. Content Type

application/json

69.1.3.5. Responses

Table 69.3. HTTP Response Codes
Code	Message	Datatype
200	A successful response.	`Object`
0	An unexpected error response.	GooglerpcStatus

69.1.3.6. Samples

69.1.4. DenyVulnerabilityRequest

POST /v1/cve/requests/{id}/deny

DenyVulnRequest denies a vulnerability request.

69.1.4.1. Description

69.1.4.2. Parameters

69.1.4.2.1. Path Parameters

Name	Description	Required	Default	Pattern
id		X	null

69.1.4.2.2. Body Parameter

Name	Description	Required	Default	Pattern
body	VulnerabilityRequestServiceDenyVulnerabilityRequestBody	X

69.1.4.3. Return Type

V1DenyVulnRequestResponse

69.1.4.4. Content Type

application/json

69.1.4.5. Responses

Table 69.4. HTTP Response Codes
Code	Message	Datatype
200	A successful response.	V1DenyVulnRequestResponse
0	An unexpected error response.	GooglerpcStatus

69.1.4.6. Samples

69.1.5. FalsePositiveVulnerability

POST /v1/cve/requests/false-positive

FalsePositiveVulnerability starts the process to mark the specified vulnerability as false-positive.

69.1.5.1. Description

69.1.5.2. Parameters

69.1.5.2.1. Body Parameter

Name	Description	Required	Default	Pattern
body	V1FalsePositiveVulnRequest	X

69.1.5.3. Return Type

V1FalsePositiveVulnResponse

69.1.5.4. Content Type

application/json

69.1.5.5. Responses

Table 69.5. HTTP Response Codes
Code	Message	Datatype
200	A successful response.	V1FalsePositiveVulnResponse
0	An unexpected error response.	GooglerpcStatus

69.1.5.6. Samples

69.1.6. GetVulnerabilityRequest

GET /v1/cve/requests/{id}

GetVulnerabilityRequest returns the requested vulnerability request by ID.

69.1.6.1. Description

69.1.6.2. Parameters

69.1.6.2.1. Path Parameters

Name	Description	Required	Default	Pattern
id		X	null

69.1.6.3. Return Type

V1GetVulnerabilityRequestResponse

69.1.6.4. Content Type

application/json

69.1.6.5. Responses

Table 69.6. HTTP Response Codes
Code	Message	Datatype
200	A successful response.	V1GetVulnerabilityRequestResponse
0	An unexpected error response.	GooglerpcStatus

69.1.6.6. Samples

69.1.7. ListVulnerabilityRequests

GET /v1/cve/requests

ListVulnerabilityRequests returns the list of vulnerability requests.

69.1.7.1. Description

69.1.7.2. Parameters

69.1.7.2.1. Query Parameters

Name	Required	Default
query	-	null
pagination.limit	-	null
pagination.offset	-	null
pagination.sortOption.field	-	null
pagination.sortOption.reversed	-	null
pagination.sortOption.aggregateBy.aggrFunc	-	UNSET
pagination.sortOption.aggregateBy.distinct	-	null

69.1.7.3. Return Type

V1ListVulnerabilityRequestsResponse

69.1.7.4. Content Type

application/json

69.1.7.5. Responses

Table 69.7. HTTP Response Codes
Code	Message	Datatype
200	A successful response.	V1ListVulnerabilityRequestsResponse
0	An unexpected error response.	GooglerpcStatus

69.1.7.6. Samples

69.1.8. UndoVulnerabilityRequest

POST /v1/cve/requests/{id}/undo

UndoVulnerabilityRequest undoes a vulnerability request.

69.1.8.1. Description

69.1.8.2. Parameters

69.1.8.2.1. Path Parameters

Name	Description	Required	Default	Pattern
id		X	null

69.1.8.3. Return Type

V1UndoVulnRequestResponse

69.1.8.4. Content Type

application/json

69.1.8.5. Responses

Table 69.8. HTTP Response Codes
Code	Message	Datatype
200	A successful response.	V1UndoVulnRequestResponse
0	An unexpected error response.	GooglerpcStatus

69.1.8.6. Samples

69.1.9. UpdateVulnerabilityRequest

POST /v1/cve/requests/{id}/update

UpdateVulnerabilityRequest updates an existing vulnerability request. Currently only deferral expiration time can be updated.

69.1.9.1. Description

69.1.9.2. Parameters

69.1.9.2.1. Path Parameters

Name	Description	Required	Default	Pattern
id		X	null

69.1.9.2.2. Body Parameter

Name	Description	Required	Default	Pattern
body	VulnerabilityRequestServiceUpdateVulnerabilityRequestBody	X

69.1.9.3. Return Type

V1UpdateVulnRequestResponse

69.1.9.4. Content Type

application/json

69.1.9.5. Responses

Table 69.9. HTTP Response Codes
Code	Message	Datatype
200	A successful response.	V1UpdateVulnRequestResponse
0	An unexpected error response.	GooglerpcStatus

69.1. Vulnerability Request Service