Skip to main content

Circuit Breaker

The circuit breaker protects your API and Staffify from cascading failures. If your API has repeated issues, the circuit breaker temporarily stops sync attempts.

How It Works

  1. 1Each failed sync increments a failure counter
  2. 2After 5 consecutive failures, the circuit breaker trips
  3. 3Syncs are blocked for 30 minutes
  4. 4After cooldown, you can try syncing again
  5. 5Successful sync resets the failure counter

When Circuit Breaker Trips

You'll see a warning in the Data Source card:

Circuit breaker triggered after 5 failures. Syncs blocked until [time]. Click Reset to try again.

Resetting the Circuit Breaker

  1. 1. Fix the underlying issue (check API credentials, endpoint URL, etc.)
  2. 2. Click the Reset button on the warning
  3. 3. Test your connection to verify it works
  4. 4. Try syncing again

Common Causes

IssueCauseSolution
401 UnauthorizedToken expired or invalidRefresh token or re-enter credentials
404 Not FoundEndpoint URL changedUpdate endpoint paths
500 Server ErrorPMS API is downWait and try later, contact PMS support
TimeoutAPI too slow or unreachableCheck network, increase timeout
Property Management - Circuit Breaker