Webhooks
Delete Webhook
Delete a specific webhook endpoint by its unique identifier.
Request Parameters:
- webhook_id: Unique identifier of the webhook to delete (path parameter)
Response Behavior:
- Successfully deletes the webhook and returns a confirmation message
- Returns 404 if webhook doesn't exist or user doesn't have access
- Returns 500 for internal server errors
Security:
- Only the webhook owner can delete their webhook
- Webhook ID must be a valid MongoDB ObjectId format
- Requires valid authentication token
Use Cases:
- Remove unused webhook endpoints
- Clean up webhook configurations
- Disable event notifications for specific URLs
- Maintain webhook hygiene and security
Important Notes:
- This action is irreversible - deleted webhooks cannot be recovered
- All webhook event subscriptions are immediately terminated
- No events will be sent to the deleted webhook URL
- Consider temporarily disabling webhooks instead of deletion for testing
Error Handling:
- 404: Webhook not found or access denied
- 500: Internal server error with detailed error information
delete/api/v1/webhooks/{webhook_id}
Path parameters
webhook_idstring required
Response
Webhook deleted successfully
Changes
No recorded changes to this endpoint across all 1 revision of this API.