API Keys
Delete API key
Revoke an API key.
DELETE /app/api-keys/{keyId}
Permanently revokes one of the authenticated user's API keys. Any requests using the revoked key will immediately begin returning 401. Users can only revoke their own keys.
Requires the API Access plan feature. Available to all authenticated users (admin and user roles).
Request
See API Basics for required headers.
Path parameters
| Parameter | Type | Description |
|---|---|---|
keyId | string | The ID of the API key to revoke (the portion before the : in the full key string). |
Sample request
curl -X DELETE https://api.recomly.com/app/api-keys/rk_live_abc123 \
-H "Authorization: Bearer rk_live_abc123:def456"Sample response
Status: 200 OK
{
"ok": true
}Error responses
See API Basics for standard status codes and error response format.
| Status | Meaning |
|---|---|
403 | The API access feature is not enabled for the organization. |

