Reset Circuit Breaker
Webhooks
Reset Circuit Breaker
POST
Reset Circuit Breaker
Resets the circuit breaker for a webhook that was automatically disabled due to consecutive failures.
Overview
When a webhook experiences too many consecutive delivery failures, the circuit breaker automatically opens to prevent further attempts. This endpoint allows you to reset the circuit breaker and re-enable the webhook after you’ve fixed the underlying issue.Authentication
Bearer token with
write:webhooks scopePath Parameters
The webhook configuration ID (UUID v4)
Response
Returns the updated webhook configuration with reset circuit breaker state.Reset to 0
Reset to null
Re-enabled (true)
Example Request
Example Response
Circuit Breaker Workflow
1
Identify Problem
Check
consecutiveFailures and circuitOpenedAt to confirm circuit is open2
Fix Issue
Resolve the underlying problem (endpoint availability, authentication, etc.)
3
Test Endpoint
Use the test endpoint to verify connectivity
4
Reset Circuit
Call this endpoint to re-enable the webhook
5
Monitor
Watch for new failures after reset
Recommended Reset Procedure
Common Causes of Circuit Breaker Trips
Authentication failures
Authentication failures
- API token expired
- Custom header value changed
- Authentication endpoint down
Timeout issues
Timeout issues
- Endpoint taking too long to respond
- Long-running synchronous processing
- Network latency
Response errors
Response errors
- Application errors (5xx)
- Validation failures (4xx)
- Incorrect response format
Error Responses
404 - Webhook Not Found
404 - Webhook Not Found
403 - Access Denied
403 - Access Denied
Related
Test Webhook
Test connectivity before resetting
Get Webhook
Check circuit breaker status