Root cause explorer
GET
workspaceTokenheader
AuthorizationBearer <vat_<opaque-token>>Expiring, hashed workspace token with explicit scopes.
workspace_id*Workspace IdFormat
uuidroot_cause_id*Root Cause IdFormat
uuidSuccessful Response
application/json- response
entities*array<>evidence*array<>findings*array<>highlighted_entity_keys*array<string>highlighted_relationship_keys*array<string>limitations?array<string>relationships*array<>remediation_programs*array<>root_cause*snapshot_id*|nullcurl -X GET 'https://api.veriom.ai/v1/workspaces/497f6eca-6276-4993-bfeb-53cbbbba6f08/structural/root-causes/497f6eca-6276-4993-bfeb-53cbbbba6f08'Example Response
{ "entities": [ { "attributes": {}, "canonical_key": "string", "confidence": "string", "contradictions": [ { "alternatives": [ { "evidence_ids": [ "973ab5a6-b373-447d-ab9d-bdb660b35afc" ], "observed_at": "2019-08-24T14:15:22Z", "source_keys": [ "string" ], "source_refs": [ "string" ], "value": "string" }, { "evidence_ids": [ "973ab5a6-b373-447d-ab9d-bdb660b35afc" ], "observed_at": "2019-08-24T14:15:22Z", "source_keys": [ "string" ], "source_refs": [ "string" ], "value": "string" } ], "detected_at": "2019-08-24T14:15:22Z", "field": "string", "resolution_summary": "string", "resolved_at": "2019-08-24T14:15:22Z", "state": "open" } ], "evidence_ids": [ "string" ], "first_observed_at": "2019-08-24T14:15:22Z", "kind": "string", "last_observed_at": "2019-08-24T14:15:22Z", "links": { "decision_ids": [ "ee5dfe1a-ec80-4b91-a667-92bab6473bc1" ], "deployment_evidence_ids": [ "b9ebcd9e-d4d0-470b-b9ae-54dd726b538e" ], "finding_ids": [ "d5d48824-6cad-498f-8feb-561fb3cdb809" ], "owner_ids": [ "f08e96b0-7632-4168-a4e6-5228d054c122" ], "remediation_ids": [ "b8f3922c-cdec-4b4e-8fb9-135818ed224f" ] }, "name": "string", "sources": [ "string" ] } ], "evidence": [ { "content_sha256": "string", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "kind": "string", "location": {}, "observed_at": "2019-08-24T14:15:22Z", "source_ref": "string", "summary": "string" } ], "findings": [ { "affected_entity_keys": [ "string" ], "affected_relationship_keys": [ "string" ], "architecture_disposition": "string", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "lifecycle_state": "string", "recommendation": "string", "repository_id": "b349ae61-b973-4c6c-a5e0-89183ba99ff3", "risk": 0, "severity": "string", "title": "string" } ], "highlighted_entity_keys": [ "string" ], "highlighted_relationship_keys": [ "string" ], "limitations": [ "string" ], "relationships": [ { "attributes": {}, "canonical_key": "string", "confidence": "string", "contradictions": [ { "alternatives": [ { "evidence_ids": [ "973ab5a6-b373-447d-ab9d-bdb660b35afc" ], "observed_at": "2019-08-24T14:15:22Z", "source_keys": [ "string" ], "source_refs": [ "string" ], "value": "string" }, { "evidence_ids": [ "973ab5a6-b373-447d-ab9d-bdb660b35afc" ], "observed_at": "2019-08-24T14:15:22Z", "source_keys": [ "string" ], "source_refs": [ "string" ], "value": "string" } ], "detected_at": "2019-08-24T14:15:22Z", "field": "string", "resolution_summary": "string", "resolved_at": "2019-08-24T14:15:22Z", "state": "open" } ], "evidence_ids": [ "string" ], "first_observed_at": "2019-08-24T14:15:22Z", "kind": "string", "last_observed_at": "2019-08-24T14:15:22Z", "links": { "decision_ids": [ "ee5dfe1a-ec80-4b91-a667-92bab6473bc1" ], "deployment_evidence_ids": [ "b9ebcd9e-d4d0-470b-b9ae-54dd726b538e" ], "finding_ids": [ "d5d48824-6cad-498f-8feb-561fb3cdb809" ], "owner_ids": [ "f08e96b0-7632-4168-a4e6-5228d054c122" ], "remediation_ids": [ "b8f3922c-cdec-4b4e-8fb9-135818ed224f" ] }, "source_key": "string", "sources": [ "string" ], "superseded_at": "2019-08-24T14:15:22Z", "supersedes_id": "8149cd94-4e90-4a99-91f5-a3e0f9b829dc", "target_key": "string" } ], "remediation_programs": [ { "activated_at": "2019-08-24T14:15:22Z", "completed_at": "2019-08-24T14:15:22Z", "created_at": "2019-08-24T14:15:22Z", "created_by": "ee824cad-d7a6-4f48-87dc-e8461a9201c4", "current_step": 0, "finding_id": "feebf65a-2eaa-4fae-aab2-772450efdffe", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "rationale": "string", "review_notes": "string", "reviewed_by": "92ab4dbc-1b27-40ce-b24b-7dde8f4709be", "root_cause_id": "b1af806c-3628-4c2b-afab-f27297369fe7", "state": "draft", "steps": [ { "evaluation_status": "string", "evidence_ids": [ "string" ], "invariant_id": "string", "invariant_version": "string", "order": 0, "owner_scope": "string", "repository_ids": [ "f3227fc5-024f-4c73-b362-d0cb9602924d" ], "review_notes": "string", "state": "ready", "title": "string", "verification_audit_id": "cef6c8ad-7eed-4189-9f94-26d2342cdd25", "verification_predicate": "string", "verified_at": "2019-08-24T14:15:22Z" } ], "target_state_ref": "string", "title": "string", "updated_at": "2019-08-24T14:15:22Z", "version": 1, "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9" } ], "root_cause": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "last_observed_audit": "11aa28b2-34da-4fce-a5de-d58014eb1a8e", "pattern_class": "string", "provenance_kind": "string", "recurrence_matches": [ { "active_finding": true, "confidence": "string", "display_name": "string", "evidence_ids": [ "973ab5a6-b373-447d-ab9d-bdb660b35afc" ], "finding_ids": [ "d5d48824-6cad-498f-8feb-561fb3cdb809" ], "last_observed_at": "2019-08-24T14:15:22Z", "snapshot_id": "163831af-8c1b-4992-a9cf-88c6306604c0", "sources": [ "string" ], "subject_key": "string", "subject_kind": "entity" } ], "recurrence_scope": 1, "remediation_tier": "string", "statement": "string", "status": "string", "target_state_ref": "string" }, "snapshot_id": "163831af-8c1b-4992-a9cf-88c6306604c0"}