Revoke an API key. Requires a user credential (an Owner or Admin) or a PORTFOLIO-scope Api-Key. Select an organization with an Organization-Id to revoke one of its keys; omit it to revoke a portfolio key if you are a portfolio Owner or Admin bearer. A PORTFOLIO Api-Key caller must always send Organization-Id naming a client in its own portfolio and can revoke only that client's keys; it can never revoke the portfolio's own portfolio-wide key. A service key (kind SERVICE) created through this API may also revoke itself: send its own token as the Api-Key and its own id in the path. The selector headers are ignored for that request. A service key that names any other id gets 401, the same as any other Api-Key that is not a PORTFOLIO key. Every other caller gets 404 if the key is not one you can revoke; the response is empty on success.
Release date, as YYYY-MM-DD. Defaults to 2026-07-21.
Target organization id (Organization-Id selector). Omit to manage portfolio keys as a bearer. Required for a PORTFOLIO-scope Api-Key, which may only manage one client org's keys at a time.
Target connection id; resolves to its organization.
Platform entity id; resolves to a connection's organization.
Optional source to disambiguate an Entity-Id.
Opaque identifier of the API key to revoke. Treat as opaque.
Successful Response
The request was invalid.
Authentication failed or was missing.
The credential is not permitted for this request.
The requested resource was not found.
The request conflicts with existing state.
The request failed validation.
A service this request depends on was unavailable. Retry the request.