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/json
  • x-api-key โ€” parent organisation API key.

Constraints

  • Returns 404 Not Found if the key does not exist, is already deleted, or does not belong to the specified child organisation.
  • Returns 404 Not Found if 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-as header 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