Set up the sync
Open Data Sources
Go to AI Training → Data Sources.
Add a GitBook source
Click Add source → GitBook.
| Field | Example | Where to get it |
|---|---|---|
| Space ID | abc123xyz | Open the space in GitBook — the ID is in the URL after /space/ or findable via the GitBook API. |
| Access Token | gb_… | Create a personal access token in your GitBook account. It must have read access to the space. |
Start the sync
Click Connect. The first run pulls all pages in the space, typically in seconds to a minute.
Verify in AI Instructions
Open AI Training → AI Instructions. Content appears under GitBook, linked to the page URLs in your GitBook space.
What gets synced
Content pages
Content pages
Every page in the space, with title and body. Nested pages flattened into the index but keep their GitBook URL.
Workspace metadata
Workspace metadata
Users, organizations, insights, and org members sync as context. The AI uses these sparingly — they’re not the main driver for answers.
Visibility
Visibility
- Published content → public
- Unpublished content → internal
Limits
| Value | |
|---|---|
| Streams synced | content, users, organizations, insights, org_members |
| Sync mode | full_refresh_append |
| Sync cadence | Airbyte polling — typically every few hours |
| Credential type | Personal access token |
| Multi-space | One space per connection (add more connections for more spaces) |
| Selective scoping | None — hide pages in GitBook to keep them out |
Related Documentation
GitBook overview
Scope and behavior.
Troubleshooting
Auth, wrong space, empty content.
Website crawler
Fallback for public GitBook sites.
Connect a knowledge source
All sources.