| 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. |
| Sync fails with 401 or 404 after connecting an API token with scopes | The token type in the source doesn’t match the token, read:page:confluence is missing, or the account can’t view the space | Edit the source and pick the token type that matches the token. Check the account has Confluence access and View on the space. Scopes can’t be added to a token later, so create a new one with the listed scopes if any are missing. |
| Connecting an API token with scopes asks for the atlassian.net address | Tokens with scopes only work with your site’s atlassian.net address, not a custom domain | Enter the domain as yourcompany.atlassian.net. |
| ”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. |
