Skip to main content
DELETE
/
v1
/
webhooks
/
{webhook_id}
curl -X DELETE https://api.ringyo.ai/v1/webhooks/wh_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "id": "wh_abc123",
  "deleted": true
}

​
Request

Permanently delete a webhook endpoint. Events will no longer be sent to this URL.
Deleting a webhook is permanent. You will need to create a new webhook to resume receiving events.

​
Headers

​
Authorization
string
required
Bearer token for authentication. Format: Bearer YOUR_API_KEY

​
Path Parameters

​
webhook_id
string
required
The unique identifier of the webhook to delete (e.g., wh_abc123)

​
Response

Returns a confirmation of deletion.
​
id
string
The ID of the deleted webhook
​
deleted
boolean
Always true on success
curl -X DELETE https://api.ringyo.ai/v1/webhooks/wh_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "id": "wh_abc123",
  "deleted": true
}

​
Error Codes

CodeDescription
webhook_not_foundThe specified webhook_id does not exist
unauthorizedYou don’t have permission to delete this webhook

​
Alternative: Disable Instead

Instead of deleting, you can disable a webhook by updating its status: 
curl -X PATCH https://api.ringyo.ai/v1/webhooks/wh_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status": "inactive"}'
This preserves the webhook configuration so you can re-enable it later.