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. 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

message
string
required