My sync didn't run
minYou expected a sync to happen and it didn't. Run through this list top to bottom — they're ordered by likelihood.
1. Check sync health on the integration
Integration → Sync health. The most recent attempt is at the top. If you see:
- "Successful, no changes" — the sync ran. There just wasn't anything new. This is the most common case people misread as "nothing happened."
- "Failed: 401/403" — the spec endpoint rejected our auth. Skip to Auth issues.
- "Failed: 5xx / timeout" — the vendor's spec endpoint is down or slow. We'll retry on the normal cadence; usually fixes itself.
- "Failed: parse error" — the document we got back wasn't a valid OpenAPI spec. See My spec won't parse.
- No recent attempts at all — keep reading.
2. Auth issues
If the spec is behind auth, our token may have rotated, expired, or the credential's permissions changed.
Integration → Spec source → Authentication. Re-enter the credential. Click Sync now. If it succeeds, you're done.
If it still fails, the credential probably doesn't have permission to read the spec endpoint. Talk to whoever owns access at the vendor.
3. Rate limiting
If a vendor returns 429 repeatedly, we automatically back off and slow the cadence to stay polite. The integration will show Rate-limited on the health card. There's nothing to fix on your end — the cadence will return to normal once their limit window resets.
If you can't wait, reach out to the vendor about a higher rate limit for spec endpoints specifically.
4. Plan caps
If you've burned through your monthly sync allowance, cadences stretch automatically. Settings → Usage will show this clearly.
Either upgrade or wait for the cycle to reset. We don't drop syncs entirely; we just slow them.
5. The integration is paused
Someone may have paused the integration manually. Integration → Settings → Status. Resume.
When to ask us
If sync health shows nothing, the integration isn't paused, you're under your usage cap, and the spec URL works in a browser — that's a real bug. Email devs@useintello.com with the integration ID. Include the timestamp of when you expected the sync.
