v1

latestOpenAPI 3.0.32026-07-17183583.3 KB
ApiKeys

Batch Verify API Keys

Verifies up to 100 credentials in parallel in a single request. Each credential is verified independently; partial failures are returned. Admin access only.

Cache Control (HTTP Headers):

  • Cache-Control: no-cache - Bypasses cache read, forces fresh DB lookup
  • Cache-Control: no-store - Bypasses cache read AND write (never cached)
  • Pragma: no-cache - Same as Cache-Control: no-cache (HTTP/1.0)

The cache directive applies to every credential in the batch.

POST /v2alpha1/admin/apiKeys:batchVerify
{
  "requests": [
    {"credential": "sk_live_abc123..."},
    {"credential": "eyJhbGciOiJFZERTQSI..."}
  ]
}
post/v2alpha1/admin/apiKeys:batchVerify

Headers

Cache-Controlstring

Cache-directive controlling the verifier cache. no-cache forces a fresh database lookup (cache read is bypassed). no-store additionally prevents the result from being written to the cache. Any other value is ignored.

Pragmastring

HTTP/1.0 alias for Cache-Control: no-cache. Behaves identically when set to no-cache; ignored otherwise.

Request body

Response

A successful response.

All 18 operations