Skip to main content
POST
/
sdk
/
revoke-verification
Revoke Pending Verification
curl --request POST \
  --url https://api.botshield.ai/operations/sdk/revoke-verification \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "scope": "<string>",
  "user_email": "[email protected]",
  "partner_user_id": "<string>"
}
'
{
  "data": {
    "success": true,
    "revoked_count": 123,
    "message": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

Your BotShield API key (e.g., bs_live_sk_... for production, bsk_test_... for test). For create-verification-link, use the session token (bss_*) returned from create-session.

Body

application/json
​
scope
string
required

The action scope to revoke pending verifications for (e.g., 'checkout.complete')

​
user_email
string<email>

User email to match. At least one of user_email or partner_user_id is required.

​
partner_user_id
string

Your platform's internal user ID to match. At least one of user_email or partner_user_id is required.

Response

Revocation result

​
data
object
required