Skip to main content
DELETE
/
v1
/
webhooks
/
{id}
Delete Webhook Endpoint
curl --request DELETE \
  --url https://api.example.com/v1/webhooks/{id} \
  --header 'Authorization: <authorization>'
{
  "success": true
}

​
Delete Webhook Endpoint

DELETE https://api.baanx.com/v1/webhooks/{id} Permanently deletes a webhook configuration.

​
Overview

Removes a webhook endpoint and stops all future event deliveries to it. This action cannot be undone. If you want to temporarily stop deliveries, consider disabling the webhook with is_active: false instead.
This action is permanent and irreversible. All configuration, including the signing key, will be lost. Event delivery to this endpoint will stop immediately.

​
Authentication

This endpoint requires authentication via Bearer token: 
Authorization: Bearer YOUR_ACCESS_TOKEN

​
Request

​
Headers

​
Authorization
string
required
Bearer token for authentication

​
Path Parameters

​
id
string (UUID)
required
Unique identifier of the webhook configuration to delete

​
Request Example

curl -X DELETE https://api.baanx.com/v1/webhooks/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

​
Response

​
200 Success

​
success
boolean
Indicates the webhook was deleted successfully
{
  "success": true
}

​
Error Responses

{
  "message": "Not authenticated"
}
  • GET /v1/webhooks - List all remaining webhook endpoints
  • POST /v1/webhooks - Create a new webhook endpoint
  • PUT /v1/webhooks/{id} - Disable a webhook temporarily (is_active: false)