Docs

Overview

Contacts

Topics

Segments

Forms

API Keys

Broadcasts

Contact Properties

Transactional Emails

Send transactional emailPOST

API Keys

DELETE

Delete API Key

DELETE /v1/api-keys/{keyId}

Delete an API key permanently.

Use Cases:

Revoke compromised or leaked API keys
Remove unused API keys
Clean up keys after decommissioning integrations
Rotate API keys for security

Behavior:

API key is permanently deleted
Key can no longer be used for authentication
Cannot delete the currently authenticated API key
Operation is immediate and cannot be undone

Required Scope: Requires API key authentication

Important:

You cannot delete the API key you're currently using
Deleted keys cannot be recovered
Any integrations using the deleted key will stop working immediately
Update all services using the key before deletion

Path parameters

keyIdstringrequired

API Key ID to delete

Response

200API key deleted successfully. Returns the deleted key's ID for confirmation.

objectstringrequired

idstringrequired

ID of the deleted API key

Request

curl -X DELETE "https://api.kibamail.com/v1/api-keys/{keyId}" \
  -H "Authorization: Bearer kb_your_api_key" \
  -H "Content-Type: application/json"

Response

API key deleted successfully. Returns the deleted key's ID for confirmation.

{
  "object": "string",
  "id": "string"
}

Copyright © 2026 Kibamail.·Privacy Policy