Clear a finding's business impact
workspaceTokenAuthorizationBearer <vat_<opaque-token>>Expiring, hashed workspace token with explicit scopes.
workspace_id*Workspace Iduuidfinding_id*Finding IduuidSuccessful Response
application/json- response
adjudicated_at*|nulladjudication_version?string|nullaffected_entity_keys*array<string>affected_relationship_keys*array<string>agent_review_decision?|nullagent_reviewed_at?|nullagent_reviewed_by?|nullallowed_transitions*array<>States a finding update may move this finding to now, in lifecycle order. Accepting risk is a separate exception workflow and never listed.
analyst_confirmed*Analyst Confirmedarchitecture_confidence?Architecture ConfidenceDeprecated for display: use conclusion_confidence. 0 whenever impact_conclusion is unknown, because there is no conclusion for a confidence to qualify.
"0"architecture_disposition?Architecture Disposition"pending""pending""architecturally_relevant""not_architecturally_relevant""needs_review"architecture_evidence_ids*array<string>architecture_impact?Architecture Impact"unknown""critical""high""medium""low""none""unknown"architecture_link*Whether it touches an architectural object, which ones and why, from its stored impact review. linked follows a confirmed or rule-detected conclusion; possible names objects the review proposed without one; not_linked follows exclusion evidence; not_reviewed has no conclusion yet.
architecture_reason*string|nullaudit_id*Audit Iduuidauto_disposition?Auto Dispositionfalsebusiness_impact?|The business impact a person set: urgent, high, moderate or low, from the customers, data and services it would affect. Null until someone sets it.
business_impact_assessment?|Who set the business impact, when, their answers and their rationale.
classification?|For findings the Security Architect published: affected objects and relationships, observed and expected condition, violated rule, evidence, consequences, contextual severity, proposed action and remediation outcome.
commit_sha*Commit Shacomponent_identity?string|nullconclusion_confidence*|Confidence in the impact conclusion, from 0 to 1, or null when impact_conclusion is unknown. For scanner findings it is the impact review model's own estimate for a conclusion the evidence gate accepted, and it is not calibrated.
confidence*Confidencecvss_score?string|nulldescription*Descriptionevidence_revision?string|nullexception*|nullexception_transitions*array<>States this finding may reach now only through a policy-exception request, which an independent Owner approves. Today that is accepting risk.
exploit*finding_class*Finding ClassWhich of the five result kinds this finding is: scanner_vulnerability, structural_finding, hypothesis, control_weakness or architectural_drift. It is orthogonal to impact_conclusion: a structural finding detected by rule reads rule_detected there, never confirmed.
"scanner_vulnerability""structural_finding""hypothesis""control_weakness""architectural_drift"finding_class_label*Finding Class LabelA plain label for finding_class, such as Structural finding.
finding_group*Finding GroupWhich Findings group it belongs to: security (a scanner reported it, such as a vulnerable dependency) or architectural (the architecture analysis reported it: a structural finding, control weakness or investigation). It follows finding_class.
"security""architectural"fingerprint_algorithm_version?Fingerprint Algorithm Version"finding-v1"first_seen_at*First Seen Atdate-timehypothesis?Hypothesisfalseid*Iduuididentity_fingerprint?string|nullimpact_conclusion*Impact ConclusionThe architecture-impact conclusion the evidence allows: confirmed (the evidence-gated impact review accepted it, the same rule as the actionable filter), not_demonstrated (the gated review accepted exclusion evidence), rule_detected (a deterministic architecture rule matched; the impact review does not assess it) or unknown (no gated conclusion yet). Every view derives it from the same fields.
"confirmed""not_demonstrated""unknown""rule_detected"last_seen_at*Last Seen Atdate-timelifecycle_started_at*Lifecycle Started Atdate-timelifecycle_state?FindingLifecycleState"new""new""persistent""regressed""remediated""accepted_risk""false_positive""duplicate""not_applicable""environment_changed"lifecycle_updated_at*Lifecycle Updated Atdate-timelifecycle_version?Lifecycle Version1 <= value1locations*array<>mappings*owner_id*|nullpending_agent_decision*|The impact review's decision on this finding that waits for a person: impact_exclusion (it excluded the open finding on evidence) or false_positive_automation (it closed the finding), or null.
proof_basis*Proof BasisOne sentence on what the proof grade means for this finding.
proof_grade?Proof GradeHow far the stored evidence goes: candidate (a rule matched), reachable (code evidence shows the affected code is used), observed (runtime or cloud evidence links to it) or verified (the evidence-gated impact review confirmed it).
"candidate""candidate""reachable""observed""verified"reachability*Reachabilityrecommendation*Recommendationrepository_id*|nullrisk_severity*Risk Severityrisk_total*Risk Totalrule_id*Rule Idscanner_severity*Scanner Severityscore_breakdown*array<>severity_source?Severity Source"risk""cvss""risk"sla_due_at*|nullsource_family?Source Family"scanner"source_label*Source LabelA plain label for where the finding came from, such as Dependency vulnerability check. Show this to customers instead of tool.
source_tools?array<>stable_fingerprint*Stable Fingerprintstate*FindingState"new""confirmed""in_remediation""fixed""false_positive""accepted_risk""reopened"structural_contract?|nullstructural_contract_version?string|nullstructural_layer?string|nullstructural_root_cause_id?|nulltaxonomy_snapshot_id?|nulltitle*Titletool*ToolDeprecatedThe capability that observed the finding, such as dependency_vulnerability_check; Veriom's own sources keep their names (analysis, veriom-structural-engine).
tool_version*Tool Versionwork_status?|The team's work on it (the collaboration status) on list and attention reads, or null when nobody has worked on it. The Findings page shows it in one status chip with state and lifecycle_state.
curl -X DELETE 'https://api.veriom.ai/v1/workspaces/497f6eca-6276-4993-bfeb-53cbbbba6f08/findings/497f6eca-6276-4993-bfeb-53cbbbba6f08/business-impact'{ "adjudicated_at": "2019-08-24T14:15:22Z", "adjudication_version": "string", "affected_entity_keys": [ "string" ], "affected_relationship_keys": [ "string" ], "agent_review_decision": "accepted", "agent_reviewed_at": "2019-08-24T14:15:22Z", "agent_reviewed_by": "76072674-51df-4c71-9894-932eea0c192f", "allowed_transitions": [ "new" ], "analyst_confirmed": true, "architecture_confidence": "0", "architecture_disposition": "pending", "architecture_evidence_ids": [ "string" ], "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", "auto_disposition": false, "business_impact": "urgent", "business_impact_assessment": { "customers": "none", "data": "none", "level": "urgent", "rationale": "string", "services": "supporting", "set_at": "2019-08-24T14:15:22Z", "set_by": "6589116c-916e-493a-b3f3-dcb3ee346f00" }, "classification": {}, "commit_sha": "string", "component_identity": "string", "conclusion_confidence": "string", "confidence": "string", "cvss_score": "string", "description": "string", "evidence_revision": "string", "exception": {}, "exception_transitions": [ "new" ], "exploit": {}, "finding_class": "scanner_vulnerability", "finding_class_label": "string", "finding_group": "security", "fingerprint_algorithm_version": "finding-v1", "first_seen_at": "2019-08-24T14:15:22Z", "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", "pending_agent_decision": "impact_exclusion", "proof_basis": "string", "proof_grade": "candidate", "reachability": "string", "recommendation": "string", "repository_id": "b349ae61-b973-4c6c-a5e0-89183ba99ff3", "risk_severity": "string", "risk_total": "string", "rule_id": "string", "scanner_severity": "string", "score_breakdown": [ {} ], "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" } ], "stable_fingerprint": "string", "state": "new", "structural_contract": {}, "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", "tool_version": "string", "work_status": "open"}