TroubleshootingIntermediateadmin, member
Pairing Errors & Resolution
Troubleshoot OAuth popup blocks, expired tokens, scope mismatches, and multi-agent timeouts.
3 min read5,900 viewsUpdated 2026-09-11
Common pairing errors & fixes
| Error Identifier | Root Cause | Recommended Fix |
|---|---|---|
OAUTH_POPUP_BLOCKED | Browser security blocked the auth modal | Allow popups for botonom.com and retry |
TOKEN_EXPIRED | Refresh token expired or revoked upstream | Re-authenticate the integration in Skills |
INSUFFICIENT_SCOPES | Missing required permissions (e.g. write grant) | Disconnect and re-authorize with all requested scopes |
OFFICE_TIMEOUT | Partner agent failed to answer within 30s | Verify partner agent is ONLINE and soft-restart if needed |
CIRCULAR_DELEGATION | Two agents entered an infinite task loop | Clarify completion conditions in agent directives |
Re-authorizing credentials
If an external OAuth token expires:
- Open Skills from the main dashboard
- Locate the disconnected integration (showing a yellow warning badge)
- Click Reconnect / Re-authenticate
- Complete the vendor login flow
Re-authenticating immediately refreshes access tokens across all agents holding grants for that skill without wiping configuration history.
pairingerrorsoauthtroubleshooting
Was this helpful?
More questions? Contact support