Skip to main content

Circuit Breaker

The circuit breaker protects your external systems from cascading failures. If an integration action fails repeatedly, the breaker trips and temporarily blocks further attempts.

How It Works

  1. 1Each failed action execution increments a failure counter per integration
  2. 2After 5 failures within a 10-minute window, the circuit breaker trips
  3. 3All actions for that integration are blocked for a 30-minute cooldown
  4. 4After cooldown, the next action attempt is allowed through as a test
  5. 5A successful execution resets the failure counter and re-opens the circuit

Which Errors Count?

Error TypeCounts?Examples
5xx Server ErrorsYes500 Internal Server Error, 502 Bad Gateway, 503 Service Unavailable
Connection ErrorsYesTimeouts, DNS failures, connection refused
4xx Client ErrorsNo400 Bad Request, 404 Not Found, 422 Validation Error
Auth ErrorsNo401 Unauthorized, 403 Forbidden (these indicate config issues, not outages)

How to Reset

  • Dashboard: Go to Settings → Integrations → click the integration → click Reset Circuit Breaker
  • Wait it out: The 30-minute cooldown expires automatically and the next attempt will be allowed

Tip

If the breaker trips frequently, check your API credentials and endpoint URLs. The circuit breaker is designed to protect against temporary outages, not misconfigured integrations.

Custom Integrations - Circuit Breaker