Skip to Content
veriom

Decide finding match suggestion

PATCH
/v1/workspaces/{workspace_id}/finding-match-suggestions/{suggestion_id}

Authorization

workspaceToken
headerAuthorizationBearer <vat_<opaque-token>>

Expiring, hashed workspace token with explicit scopes.

Path Parameters

workspace_id*Workspace Id
Formatuuid
suggestion_id*Suggestion Id
Formatuuid

Request Body

application/json
  1. body
reason*Reason
Length3 <= length <= 2000
state*State
Value in"confirmed""rejected"

Response Body

Successful Response

application/json
  1. response
algorithm_version*Algorithm Version
created_at*Created At
Formatdate-time
decided_at*|null
decided_by*|null
id*Id
Formatuuid
left_finding_id*Left Finding Id
Formatuuid
method*Method
rationale*Rationale
review?|null
right_finding_id*Right Finding Id
Formatuuid
similarity*Similarity
state*State
Value in"pending""confirmed""rejected"
Example Request
curl -X PATCH 'https://api.veriom.ai/v1/workspaces/497f6eca-6276-4993-bfeb-53cbbbba6f08/finding-match-suggestions/497f6eca-6276-4993-bfeb-53cbbbba6f08' \  -H 'Content-Type: application/json' \  -d '{  "reason": "string",  "state": "confirmed"}'
Example Response
{  "algorithm_version": "string",  "created_at": "2019-08-24T14:15:22Z",  "decided_at": "2019-08-24T14:15:22Z",  "decided_by": "4accc021-c0cc-4c2c-8a78-605a0ed6da31",  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "left_finding_id": "ab2a9365-93af-4416-a93b-fd7875de25e2",  "method": "string",  "rationale": "string",  "review": {    "can_decide": false,    "differences": [      "string"    ],    "left": {      "adjudication_version": "string",      "architecture_confidence": "0",      "architecture_disposition": "pending",      "architecture_impact": "critical",      "architecture_link": {        "object_count": 0,        "objects": [          {            "key": "string",            "kind": "string",            "kind_label": "string",            "name": "string"          }        ],        "reason": "string",        "state": "linked"      },      "architecture_reason": "string",      "audit_id": "78c04fa6-cfb4-46a0-9aa5-3681ba4f3897",      "audit_status": "string",      "auto_disposition": false,      "business_impact": "urgent",      "component_identity": "string",      "conclusion_confidence": "string",      "cvss_score": "string",      "description": "string",      "evidence_count": 0,      "evidence_revision": "string",      "finding_class": "scanner_vulnerability",      "finding_class_label": "string",      "finding_group": "security",      "fingerprint_algorithm_version": "finding-v1",      "hypothesis": false,      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "identity_fingerprint": "string",      "impact_conclusion": "confirmed",      "last_seen_at": "2019-08-24T14:15:22Z",      "lifecycle_started_at": "2019-08-24T14:15:22Z",      "lifecycle_state": "new",      "lifecycle_updated_at": "2019-08-24T14:15:22Z",      "lifecycle_version": 1,      "locations": [        {}      ],      "mappings": {        "property1": [          "string"        ],        "property2": [          "string"        ]      },      "owner_id": "8826ee2e-7933-4665-aef2-2393f84a0d05",      "proof_grade": "candidate",      "repository_id": "b349ae61-b973-4c6c-a5e0-89183ba99ff3",      "repository_name": "string",      "risk_severity": "string",      "risk_total": "string",      "rule_id": "string",      "scanner_severity": "string",      "severity_source": "cvss",      "sla_due_at": "2019-08-24T14:15:22Z",      "source_family": "scanner",      "source_label": "string",      "source_tools": [        {          "rule_id": "string",          "tool": "string",          "version": "string"        }      ],      "state": "new",      "structural_contract_version": "string",      "structural_layer": "string",      "structural_root_cause_id": "51d97e66-655e-47cc-b147-d97f2b4d419b",      "taxonomy_snapshot_id": "487bda72-1129-4a41-8441-bc24f9e8006b",      "title": "string",      "tool": "string",      "work_status": "open"    },    "matching_signals": [      "string"    ],    "right": {      "adjudication_version": "string",      "architecture_confidence": "0",      "architecture_disposition": "pending",      "architecture_impact": "critical",      "architecture_link": {        "object_count": 0,        "objects": [          {            "key": "string",            "kind": "string",            "kind_label": "string",            "name": "string"          }        ],        "reason": "string",        "state": "linked"      },      "architecture_reason": "string",      "audit_id": "78c04fa6-cfb4-46a0-9aa5-3681ba4f3897",      "audit_status": "string",      "auto_disposition": false,      "business_impact": "urgent",      "component_identity": "string",      "conclusion_confidence": "string",      "cvss_score": "string",      "description": "string",      "evidence_count": 0,      "evidence_revision": "string",      "finding_class": "scanner_vulnerability",      "finding_class_label": "string",      "finding_group": "security",      "fingerprint_algorithm_version": "finding-v1",      "hypothesis": false,      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "identity_fingerprint": "string",      "impact_conclusion": "confirmed",      "last_seen_at": "2019-08-24T14:15:22Z",      "lifecycle_started_at": "2019-08-24T14:15:22Z",      "lifecycle_state": "new",      "lifecycle_updated_at": "2019-08-24T14:15:22Z",      "lifecycle_version": 1,      "locations": [        {}      ],      "mappings": {        "property1": [          "string"        ],        "property2": [          "string"        ]      },      "owner_id": "8826ee2e-7933-4665-aef2-2393f84a0d05",      "proof_grade": "candidate",      "repository_id": "b349ae61-b973-4c6c-a5e0-89183ba99ff3",      "repository_name": "string",      "risk_severity": "string",      "risk_total": "string",      "rule_id": "string",      "scanner_severity": "string",      "severity_source": "cvss",      "sla_due_at": "2019-08-24T14:15:22Z",      "source_family": "scanner",      "source_label": "string",      "source_tools": [        {          "rule_id": "string",          "tool": "string",          "version": "string"        }      ],      "state": "new",      "structural_contract_version": "string",      "structural_layer": "string",      "structural_root_cause_id": "51d97e66-655e-47cc-b147-d97f2b4d419b",      "taxonomy_snapshot_id": "487bda72-1129-4a41-8441-bc24f9e8006b",      "title": "string",      "tool": "string",      "work_status": "open"    },    "summary": "string",    "unavailable_reason": "string"  },  "right_finding_id": "04e9a9b0-eb9d-42f5-b48d-e87078ac0e25",  "similarity": "string",  "state": "pending"}