Skip to main content
POST
Block a verification face

Authorizations

X-API-Key
string
header
required

Your workspace public key (pk_test_… or pk_live_…).

X-HMAC-Signature
string
header
required

HMAC-SHA256 of the request, hex-encoded, keyed with the workspace secret key. See API authentication.

Path Parameters

verification
string<uuid>
required

The verification ID

Body

application/json
reason_code
enum<string>

Why a person put this face on the blocklist. The admin consoles require one; the public API accepts it optionally, and propagated device matches carry none.

Available options:
presentation_attack,
fraudulent_document,
scam_or_abuse,
underage,
other
reason
string | null

Free text stored with the block; longer text is cut at 1000 characters.

Response

No content