API Keys
Delete API key
Revoke an API key.
DELETE /app/api-keys/{keyId}
Permanently revokes one of the authenticated user's API keys. The next request using that key is rejected with 403 Forbidden. Users can only revoke their own keys.
Requires the API access feature entitlement (enabledFeatures.api).
Path parameters
| Parameter | Type | Description |
|---|---|---|
keyId | string | The ID of the API key to revoke (the portion before the : in the full key string). |
Request
See API Basics for required headers.
Sample request
curl -X DELETE https://api.statusdashboard.com/app/api-keys/bcf847abf5c6 \
-H "Authorization: Bearer bcf847abf5c6:def456"Sample response
Status: 204 No Content
No response body.
Error responses
| Status | When |
|---|---|
403 | Invalid or revoked API key, missing API access feature, or insufficient permissions. |