Common scenarios
| Symptom | Likely cause | Fix |
|---|---|---|
| Sync fails with 401 / unauthorized | API token is invalid, revoked, or belongs to an account that doesn’t have Confluence access | Re-generate the token at Atlassian API tokens. Confirm the email matches the token owner. Update both fields in the source. |
| ”Space not accessible” errors in the logs | The token’s account doesn’t have read permission for some spaces | Grant read access to the Confluence user in Atlassian space settings, or accept that restricted spaces are skipped. The rest of the sync proceeds. |
| Pages from a personal space show as internal and the AI never cites them in customer replies | Working as designed — personal spaces (keys starting with ~) are marked internal | Override visibility per-page in AI Instructions, or move the content to a non-personal space in Confluence. |
| Sync is extremely slow / times out on a huge instance | full_refresh_overwrite pulls every page every run | Reduce the Confluence connection’s sync cadence in the Airbyte schedule. If your instance has thousands of pages, consider breaking content out into a dedicated space and using the Website crawler against a public mirror. |
| Source URLs in the AI’s citations are missing or wrong | The webui path is only assembled when the backend can look up your Confluence domain; if the domain didn’t save, URLs are empty | Re-enter the Domain field exactly as yourcompany.atlassian.net (no scheme, no trailing slash). Trigger a re-sync. |
| Confluence Server / Data Center | Not supported today | Cloud only. Migrate or use the Website crawler against a published export. |
| None of the above | — | Contact support with the connection ID and sample page URL. |
Related Documentation
Connect Confluence
Re-check credentials and limits.
Confluence overview
What this source does.
Website crawler
Fallback for scoped subsets.
Connect a knowledge source
All sources.