Revoke one of my API keys
Revoke an API key. Once revoked, a key cannot be reactivated.
-
A request authenticated with a role-scoped API key may revoke that key itself;
revoking one of the owner's other keys requires
api-keys:manageon the key's role and is otherwise refused with 403. - Under API-key authentication, the acting key may revoke the owner's other keys only in the tenant it is pinned to; elsewhere the request is refused with 403.
Path Parameters
- Type: stringkey
Id requiredAPI key ID to revoke
Responses
- 204
No Content (204) - Operation completed successfully with no response body
- application/json
- 403
Access denied - a role-scoped API key without api-keys:manage may only revoke itself, and any API key may revoke the owner's other keys only in the tenant it is pinned to.
- application/json
Request Example for delete/auth/api-keys/me/{keyId}
curl 'https://api.gpcn.com/v1/auth/api-keys/me/{keyId}' \
--request DELETE \
--header 'X-API-Key: YOUR_SECRET_TOKEN'
No Body
.png)