Troubleshooting
Common Issues
| Error | Cause | Solution |
|---|---|---|
| 401 Unauthorized | Invalid/expired token | Check credentials, enable auto-refresh |
| Connection refused | API unreachable | Check URL, firewall |
| Timeout | Server too slow | Increase timeout, optimize API |
| Circuit breaker | 5+ failures | Fix underlying issue, reset manually |
Token Refresh Issues
| Error | Solution |
|---|---|
| invalid_grant | Re-authenticate with provider |
| invalid_client | Check Client ID/Secret |
| Refresh keeps failing | Check provider status |