Skip to main content
POST
Confirm or override file risk score
Allow users to confirm the current AI-generated risk score or override it with a new value. This endpoint allows for human-in-the-loop validation of automated findings. An optional confirmation reason can be provided to document the decision.

Permission

You can confirm the score of a file you uploaded, or any file in your organisation if you have organisation_files:read. Changing the score to a different value also requires organisation_files:override_risk_score, which the Owner, Admin and Analyst roles hold by default; without it the API returns 403. Shared cases, if enabled for your organisation, also give you reach to every case and file. See Permissions and API Keys.

Best Practices

  1. Document Decisions: Always provide a confirmation_reason when overriding AI assessments to maintain a clear audit trail.
  2. Review Full Analysis: Always examine the detailed findings from the Get File Analysis endpoint before confirming or changing a score.
  3. Wait for Completion: Risk scores can only be confirmed once the file analysis has successfully reached the settled status.

Authorizations

x-api-key
string
header
required

Path Parameters

fileId
string
required

File ID

Body

application/json
risk_score
enum<string>
required
Available options:
informational,
low,
medium,
high
confirmation_reason
string
Maximum string length: 1000

Response

Risk score confirmation created successfully

The response is of type object.