STstytch
Fraud

Override

Changed on

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.

post/v1/verdict_reasons/override

Request

  • Base URL
    https://telemetry.stytch.com
  • Auth
    HTTP basic

Request body

verdict_reasonstring required

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'ALLOW' | 'CHALLENGE' | 'BLOCK' | 'NONE' required
override_descriptionstring

An optional description for the verdict reason override.

Response

Successful response

request_idstring required

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_codeinteger required

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.

Changes