Revoke an API key
Permanently revoke a key so it can no longer authenticate requests.
DELETE
/api/admin/api-keys/{id}
🔒 API key · admin rolePermanently revokes a key. Any request using it afterward is rejected. Use this when a key is compromised or no longer needed.
Path parameters
| Parameter | Type | Description |
|---|---|---|
id | string | The API key ID to revoke. |
Example request
curl -X DELETE https://app.talent-ray.com/api/admin/api-keys/apikey_xyz789 \
-H "Authorization: Bearer tr_YOUR_ADMIN_KEY"
Response
200 OK
{
"success": true
}
Status codes
| Status | Meaning |
|---|---|
200 | Key revoked. |
401 | No valid API key. |
403 | Caller is not an admin. |
404 | Key not found. |
429 | Rate limited. |