Connection Health¶
GloriaMundo actively monitors the health of your app connections to prevent workflow failures from expired tokens.
Provider Tiers¶
Different apps handle authentication tokens differently. GloriaMundo classifies providers into three tiers based on their token refresh patterns:
Tier 1 — Auto-Refresh (No Expiry)¶
These providers support automatic token refresh. Connections typically don't expire unless you manually revoke access.
Examples: Gmail, Google Calendar, Google Drive, Google Sheets, Slack, HubSpot, Salesforce, Shopify, Dropbox, Zoom, Intercom, Trello, Monday
You generally don't need to worry about Tier 1 connections — they stay active indefinitely.
Tier 2 — Long-Lived (60–365 Days)¶
These providers issue tokens that last weeks to months. GloriaMundo tracks the expected expiry date and warns you in advance.
| App | Token Lifetime |
|---|---|
| GitHub | Typically 365 days |
| Typically 365 days | |
| Asana | Typically 180 days |
| OneDrive | Typically 90 days |
| Jira | Typically 90 days |
| Airtable | Typically 60 days |
Tier 3 — Short-Lived (30–180 Days)¶
These providers issue shorter-lived tokens. You may need to reconnect periodically.
| App | Token Lifetime |
|---|---|
| Twitter/X | Typically 180 days |
| Notion | Typically 90 days |
| Discord | Typically 30 days |
Note: Token lifetimes are approximate and may change. Verify against each provider's current OAuth documentation for authoritative values.
Expiry Warnings¶
GloriaMundo warns you as connections approach expiry:
| Warning Level | Condition | Indicator |
|---|---|---|
| Warning | Expires within 7 days | Yellow badge |
| Danger | Expires within 3 days or already expired | Red badge |
Warnings appear on:
- The Connections page next to the affected connection
- The sidebar badge on the Connections icon
Automatic Health Monitoring¶
GloriaMundo runs background health checks every 6 hours to keep your connection states current. These checks:
- Compare local connection records against the actual state in Composio
- Detect connections that have expired or been revoked
- Attempt automatic token refresh for expired connections where possible
- Update status indicators so you see current information
You don't need to do anything to enable this — it runs automatically for all users with active connections.
Composio Webhook¶
When a connection expires on the Composio side, a webhook notification is sent to GloriaMundo in real time. This means:
- Expiry detection happens immediately, not just every 6 hours
- GloriaMundo automatically attempts to refresh the expired token
- If automatic refresh fails, the connection is marked as expired and you'll see a notification
What to Do When a Connection Expires¶
- Go to the Connections page
- Find the expired connection (marked with a red indicator)
- Click Refresh to attempt an automatic refresh
- If refresh fails, click Reconnect to go through the OAuth flow again
Tip
If you see a connection expiry warning, refresh it before it fully expires to avoid any workflow interruptions.
Pre-Flight Connection Checks¶
Before any workflow runs (including Virtual Runs), GloriaMundo checks that all required connections are active. If a connection is missing or expired, the run is blocked and you're prompted to reconnect.