Delete Child Key
Delete (revoke) an API key for a child organisation.
This performs a soft-delete: the key's deletedAt timestamp is set, and it will no longer authenticate requests. The key row is preserved in the database for audit purposes.
Returns 204 No Content on success with no response body.
โถRequest
โถMethod & Path
DELETE /organizations/children/:id/keys/:keyId
โถPath parameters
idโ UUID of the child organisation.keyIdโ UUID of the API key to delete.
โถHeaders
Accept: application/jsonx-api-keyโ parent organisation API key.
โถConstraints
- Returns
404 Not Foundif the key does not exist, is already deleted, or does not belong to the specified child organisation. - Returns
404 Not Foundif the child organisation does not exist or is not owned by the caller. - Caller must be a top-level organisation (not a child).
- The
x-acting-asheader must not be set.
โถKey lifecycle
When a parent-child relationship is severed (via DELETE /organizations/children/:id), all API keys created by the parent for that child are automatically revoked.
Required scope:
organizations:write