webhook.config.delete
Delete a webhook endpoint configuration.
POST http://api.kompliant.com/webhook.config.delete (OpenAPI specification)
Usage Info
This method soft-deletes a webhook URL configuration. Once deleted, the configuration will no longer receive webhook deliveries and cannot be retrieved via webhook.config.get or webhook.config.list.
Deletion is permanent — deleted configurations cannot be restored. If you need to stop deliveries temporarily, consider not activating a webhook key instead.
Attempting to delete an already-deleted configuration will result in an ENTITY_NOT_FOUND error.
Request
Authentication: KSig1-HMAC-SHA256
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| account_id | string | Yes | The account identifier the webhook configuration belongs to. |
| config_id | string | Yes | The identifier of the webhook configuration to delete. |
Example
{
"account_id": "account_id",
"config_id": "whc_2K9mPxR7N4jL8hS6TdWfY3"
}
Response
A successful deletion returns an empty data object.
Example
{
"meta": {
"status": "SUCCESS",
"trace_id": "trc_3OwNmn7AgCvLGqeCIjKjSD",
"version": "2025-03-24"
},
"data": {}
}
Errors
| Error Code | HTTP Code | Possible Cause |
|---|---|---|
| BAD_REQUEST | 400 | Required parameters not provided. config_id format is invalid. |
| ENTITY_NOT_FOUND | 404 | The config_id does not exist or has already been deleted for this account. |
Updated 28 days ago