New: MCP server monitoring is live. Start free

My sync didn't run

min

You 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.

Catch OpenAPI breaking changes early

Add your spec—diffs and alerts on every sync. No credit card to start; upgrade for faster polling, Slack or Teams, and more seats.