Sources API — Manage Training Content - InsiteChat

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