Api referenceFindings

Update Finding

Reference for Update Finding in the Veriom v1 API, including request, response, and authentication details.

PATCH/v1/workspaces/{workspace_id}/findings/{finding_id}

Update Finding. Returns a typed response and a request ID for operational support.

Authorization

veriom_session<token>

Opaque HttpOnly customer session. Mutations also require X-CSRF-Token.

In: cookie

Path Parameters

workspace_id*Workspace Id
Formatuuid
finding_id*Finding Id
Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X PATCH "https://example.com/v1/workspaces/497f6eca-6276-4993-bfeb-53cbbbba6f08/findings/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{    "state": "new"  }'
{
  "adjudicated_at": "2019-08-24T14:15:22Z",
  "adjudication_version": "string",
  "affected_entity_keys": [
    "string"
  ],
  "affected_relationship_keys": [
    "string"
  ],
  "analyst_confirmed": true,
  "architecture_confidence": "0",
  "architecture_disposition": "pending",
  "architecture_evidence_ids": [
    "string"
  ],
  "architecture_impact": "critical",
  "architecture_reason": "string",
  "audit_id": "78c04fa6-cfb4-46a0-9aa5-3681ba4f3897",
  "auto_disposition": false,
  "commit_sha": "string",
  "component_identity": "string",
  "confidence": "string",
  "cvss_score": "string",
  "description": "string",
  "evidence_revision": "string",
  "exception": {},
  "exploit": {},
  "fingerprint_algorithm_version": "finding-v1",
  "first_seen_at": "2019-08-24T14:15:22Z",
  "hypothesis": true,
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "identity_fingerprint": "string",
  "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",
  "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_tools": [
    {
      "rule_id": "string",
      "tool": "string",
      "version": "string"
    }
  ],
  "stable_fingerprint": "string",
  "state": "new",
  "title": "string",
  "tool": "string",
  "tool_version": "string"
}
{
  "code": "validation_failed",
  "detail": "The request body did not match the documented schema.",
  "instance": "/v1/audits",
  "request_id": "018f6f5d-36a2-7a2d-a8f6-ec1a55c03e45",
  "status": 422,
  "title": "Validation Failed",
  "type": "https://api.veriom.ai/problems/validation_failed"
}
{
  "code": "validation_failed",
  "detail": "The request body did not match the documented schema.",
  "instance": "/v1/audits",
  "request_id": "018f6f5d-36a2-7a2d-a8f6-ec1a55c03e45",
  "status": 422,
  "title": "Validation Failed",
  "type": "https://api.veriom.ai/problems/validation_failed"
}
{
  "code": "validation_failed",
  "detail": "The request body did not match the documented schema.",
  "instance": "/v1/audits",
  "request_id": "018f6f5d-36a2-7a2d-a8f6-ec1a55c03e45",
  "status": 422,
  "title": "Validation Failed",
  "type": "https://api.veriom.ai/problems/validation_failed"
}
{
  "code": "validation_failed",
  "detail": "The request body did not match the documented schema.",
  "instance": "/v1/audits",
  "request_id": "018f6f5d-36a2-7a2d-a8f6-ec1a55c03e45",
  "status": 422,
  "title": "Validation Failed",
  "type": "https://api.veriom.ai/problems/validation_failed"
}
{
  "code": "validation_failed",
  "detail": "The request body did not match the documented schema.",
  "instance": "/v1/audits",
  "request_id": "018f6f5d-36a2-7a2d-a8f6-ec1a55c03e45",
  "status": 422,
  "title": "Validation Failed",
  "type": "https://api.veriom.ai/problems/validation_failed"
}
{
  "code": "validation_failed",
  "detail": "The request body did not match the documented schema.",
  "instance": "/v1/audits",
  "request_id": "018f6f5d-36a2-7a2d-a8f6-ec1a55c03e45",
  "status": 422,
  "title": "Validation Failed",
  "type": "https://api.veriom.ai/problems/validation_failed"
}
{
  "code": "validation_failed",
  "detail": "The request body did not match the documented schema.",
  "instance": "/v1/audits",
  "request_id": "018f6f5d-36a2-7a2d-a8f6-ec1a55c03e45",
  "status": 422,
  "title": "Validation Failed",
  "type": "https://api.veriom.ai/problems/validation_failed"
}