upsertFinding

Request
Security:
vc-security
Request Body schema: application/json
id
string
object (Source)
title
required
string
category
string
type
string
backgrounds
Array of strings
recommendations
Array of strings
notes
string
orgId
required
string
orgPaths
required
Array of strings
severity
required
string (Severity)
Default: "UNKNOWN"
Enum: "UNKNOWN" "INFO" "LOW" "MEDIUM" "HIGH" "CRITICAL"
confidence
string (Confidence)
Enum: "TENTATIVE" "FIRM" "CERTAIN"
pciSeverity
string (PciSeverity)
Enum: "LOW" "MEDIUM" "HIGH" "CRITICAL" "URGENT"
priority
integer <int32>
customerPriority
integer <int32>
required
Array of objects (Tag)
required
Array of objects (AssetKey)
eventIds
required
Array of strings
affectedItems
required
Array of strings
references
required
Array of strings
required
Array of objects (Evidence)
sourcePlugins
required
Array of strings
sourceTags
required
Array of strings
cvssV2Vector
string
cvssV2Score
number <double>
cvssV3Vector
string
cvssV3Score
number <double>
cvssV4Vector
string
cvssV4Score
number <double>
cvssV4Exploitability
string
cvssV4Complexity
string
cvssV4VulnerableSystem
string
cvssV4SubsequentSystem
string
cvssV4Exploitation
string
cvssV4SecurityRequirements
string
cves
required
Array of strings
cwes
required
Array of strings
raw
string
externalId
string
externalEventIds
required
Array of strings
required
Array of objects (KeyValue)
pciPass
boolean
required
Array of objects (Workflow)
Array of objects (Event)
isTemplate
boolean
Default: false
isDeleted
boolean
Default: false
createdInstant
string <date-time>
lastUpdated
string <date-time>
Responses
200

OK

400

Bad Request. The request parameters (or body) were malformed or invalid. Fix the issues with the request and try again.

401

Unauthorized request. Make sure token was included and is valid and try again.

403

Forbidden. You are not permitted to access the requested resource.

404

Not Found. The specified resource (or resource referred to by id) was not found

405

Method Not Allowed. The API was accessed with the wrong method

500

Internal Server Error. An unexpected error has occurred. This may be due to a transient error. Retry the request and if the issue persists, please contact support.

503

Service Unavailable. The service is temporarily unavailable. Try your request later.

post/finding-service/v1/finding
Request samples
application/json
{
  • "id": "string",
  • "submissionSource": {
    },
  • "title": "string",
  • "category": "string",
  • "type": "string",
  • "backgrounds": [
    ],
  • "recommendations": [
    ],
  • "notes": "string",
  • "orgId": "string",
  • "orgPaths": [
    ],
  • "severity": "UNKNOWN",
  • "confidence": "TENTATIVE",
  • "pciSeverity": "LOW",
  • "priority": 0,
  • "customerPriority": 0,
  • "tags": [
    ],
  • "assetKeys": [
    ],
  • "eventIds": [
    ],
  • "affectedItems": [
    ],
  • "references": [
    ],
  • "evidences": [
    ],
  • "sourcePlugins": [
    ],
  • "sourceTags": [
    ],
  • "cvssV2Vector": "string",
  • "cvssV2Score": 0,
  • "cvssV3Vector": "string",
  • "cvssV3Score": 0,
  • "cvssV4Vector": "string",
  • "cvssV4Score": 0,
  • "cvssV4Exploitability": "string",
  • "cvssV4Complexity": "string",
  • "cvssV4VulnerableSystem": "string",
  • "cvssV4SubsequentSystem": "string",
  • "cvssV4Exploitation": "string",
  • "cvssV4SecurityRequirements": "string",
  • "cves": [
    ],
  • "cwes": [
    ],
  • "raw": "string",
  • "externalId": "string",
  • "externalEventIds": [
    ],
  • "extras": [
    ],
  • "pciPass": true,
  • "workflows": [
    ],
  • "events": [
    ],
  • "isTemplate": false,
  • "isDeleted": false,
  • "createdInstant": "2019-08-24T14:15:22Z",
  • "lastUpdated": "2019-08-24T14:15:22Z"
}
Response samples
application/json
"string"