Set Verdict Reason Override

POST

https://telemetry.stytch.com/v1/verdict_reasons/override

Use this endpoint to override the action returned for a specific verdict reason during a fingerprint lookup. For example, Stytch Device Fingerprinting returns a CHALLENGE verdict action by default for the verdict reason VIRTUAL_MACHINE. You can use this endpoint to override that reason to return an ALLOW verdict instead if you expect many legitimate users to be using a browser that runs in a virtual machine.

Body parameters

verdict_reason* string

override_action* string

override_description string

Response fields

request_id string

status_code int

verdict_reason_action object

const stytch = require('stytch');

const client = new stytch.Client({
  project_id: 'PROJECT_ID',
  secret: 'SECRET',
});

const params = {
  verdict_reason: "VIRTUAL_MACHINE",
  override_action: "ALLOW",
};

client.fraud.verdictReasons.override(params)
  .then(resp => { console.log(resp) })
  .catch(err => { console.log(err) });

RESPONSE

{
  "verdict_reason_override": {
    "default_action": "CHALLENGE",
    "override_action": "ALLOW",
    "override_created_at": "2025-06-09T00:00:00Z",
    "override_description": null,
    "verdict_reason": "VIRTUAL_MACHINE"
  },
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "status_code": 200
}