Documentation Index
Fetch the complete documentation index at: https://docs.insitechat.ai/llms.txt
Use this file to discover all available pages before exploring further.
A read-only InsiteChat API endpoint that lists every active training source on a chatbot — websites, uploaded files, Google Drive folders, Notion pages, Dropbox files, custom Q&A, and more. Use it to inspect what your chatbot is trained on, monitor crawl status, or build sync dashboards.
List Sources
Returns every source on the chatbot (excluding soft-deleted ones), newest first.
Request
GET /v1/chatbots/{chatbot_id}/sources
| Path parameter | Type | Required | Description |
|---|
chatbot_id | UUID | yes | The chatbot’s UUID. Must be owned by the API key’s user. |
curl https://backend.insitechat.ai/api/v1/chatbots/0a1b2c3d-4e5f-6789-abcd-ef0123456789/sources \
-H "Authorization: Bearer ic_your-api-key"
Response
A bare JSON array (no wrapping envelope):
[
{
"id": "ab12cd34-5e6f-7890-abcd-ef1234567890",
"type": "url",
"title": "Acme Help Center",
"url": "https://help.acme.com",
"status": "done",
"page_count": 42,
"created_at": "2026-04-01T10:00:00.123456+00:00"
},
{
"id": "cd34ef56-7890-abcd-ef12-3456789012cd",
"type": "file",
"title": "Product Datasheet.pdf",
"url": "",
"status": "processing",
"page_count": 0,
"created_at": "2026-04-10T14:22:00.654321+00:00"
}
]
Response Fields
| Field | Type | Description |
|---|
id | UUID | Source identifier. |
type | string | One of the source types listed below. |
title | string | Display title (filename for files, page title for URLs, user-supplied label for text). May be empty if not yet set. |
url | string | The crawled URL (for url sources) or empty for non-URL types. |
status | string | pending, crawling, processing, done, or failed. |
page_count | integer | Pages successfully indexed (URL crawls and multi-page files); 0 for single-document or pre-ingest sources. |
created_at | string | ISO 8601 timestamp. |
Source Types
| Type | Description |
|---|
url | Website URL (crawled) |
file | Uploaded file (PDF, DOCX, PPTX, TXT, MD, CSV) |
text | Raw text snippet |
youtube | YouTube video transcript |
google_drive | Google Drive file |
notion | Notion page |
dropbox | Dropbox file |
onedrive | OneDrive file (backend type only — not yet exposed in the dashboard’s Add Source picker) |
sharepoint | SharePoint file (backend type only — not yet exposed in the dashboard’s Add Source picker) |
zendesk | Zendesk Help Center article (backend type only — not yet exposed in the dashboard’s Add Source picker) |
gitbook | GitBook page (backend type only — not yet exposed in the dashboard’s Add Source picker) |
The “backend type only” rows above mean the type can appear in API responses on accounts where support has manually enabled the source, but you can’t add new sources of those types from the dashboard yet. See Source Management for the current UI inventory. Error Responses
Error bodies use Django Ninja’s default {"detail": "..."} shape.
| Status | When |
|---|
401 | Missing, invalid, or revoked API key |
404 | No chatbot exists with that UUID, or it belongs to a different user |
429 | Per-key rate limit exceeded |
