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.
Set Verdict Reason Override
POST
https://telemetry.stytch.com/v1/verdict_reasons/overrideBody parameters
verdict_reason* string
The verdict reason that you wish to override. For a list of possible reasons to override, see Warning Flags (Verdict Reasons). You may not override the RULE_MATCH reason.
override_action* string
The action that you want to be returned for the specified verdict reason. The override action must be one of ALLOW, BLOCK, or CHALLENGE.
override_description string
An optional description for the verdict reason override.
Response fields
request_id string
Globally unique UUID that is returned with every API call. This value is important to log for debugging purposes; we may ask for this value to help identify a specific API call when helping you debug an issue.
status_code int
The HTTP status code of the response. Stytch follows standard HTTP response status code patterns, e.g. 2XX values equate to success, 3XX values are redirects, 4XX are client errors, and 5XX are server errors.
verdict_reason_action object
Information about the verdict reason override that was just set.
verdict_reason string
The verdict reason that was overridden.
override_action string
The action that will now be returned for the specified verdict reason in a fingerprint lookup.
default_action string
The default action returned for the specified verdict reason in a fingerprint lookup when no overrides are specified.
override_created_at string
The time when the override was created. Values conform to the RFC 3339 standard and are expressed in UTC, e.g. 2021-12-29T12:33:09Z.
override_description string
A description of the override, if provided.
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 200
200
{
"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
}RESPONSE 401
200
{
"status_code": 401,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "unauthorized_credentials",
"error_message": "Unauthorized credentials.",
"error_url": "https://stytch.com/docs/api/errors/401"
}RESPONSE 429
200
{
"status_code": 429,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "too_many_requests",
"error_message": "Too many requests have been made.",
"error_url": "https://stytch.com/docs/api/errors/429"
}RESPONSE 500
200
{
"status_code": 500,
"request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
"error_type": "internal_server_error",
"error_message": "Oops, something seems to have gone wrong, please reach out to support@stytch.com to let us know what went wrong.",
"error_url": "https://stytch.com/docs/api/errors/500"
}