Skip to content
cascadehook.docs
API referenceAPI keys

Revoke an API key

EMPTY BODY, no query parameters. Requires explicit human approval. Cannot revoke the last usable key without a replacement.

DELETE
/v1/api-keys/{api_key_id}

EMPTY BODY, no query parameters. Requires explicit human approval. Cannot revoke the last usable key without a replacement.

Authorization

projectAPIKey
headerAuthorizationBearer <ch_dev_ or ch_live_ project API key>

Read CASCADEHOOK_API_KEY from the local environment. Never print keys or headers. Scope is the project selected when the key was created.

Path Parameters

api_key_id*string
Formatuuid

Response Body

Revocation confirmed.

Example Request
curl -X DELETE 'https://api.cascadehook.com/v1/api-keys/497f6eca-6276-4993-bfeb-53cbbbba6f08'
Example Response
Empty

List API key metadata GET

Returns newest-first retained data. Unknown or repeated query parameters are rejected. Follow next_cursor until null; preserve filters. Omit cursor on the first page. Metadata excludes complete credentials.

Rotate an API key POST

EMPTY BODY, no query parameters. Requires explicit human approval. Existing replacement/inactive key conflicts; never rotate automatically on an ambiguous response.