List knowledge sources
Returns all the sources in an agent’s knowledge base, sorted by creation date in descending order.GET https://app.chatnorris.ai/api/v2/chatbots/{chatbot_id}/knowledge
Authorization: Bearer <your_api_key>
chatbots:read
Path parameters
| Parameter | Type | Description |
|---|---|---|
chatbot_id | string | Agent ID |
Response
{
"status": "success",
"data": {
"sources": [
{
"id": "src_abc123",
"name": "FAQ page",
"type": "url",
"status": "ready",
"source_url": "https://empresa.com/faq",
"char_count": 12540,
"chunk_count": 18,
"last_synced": "2026-06-28T10:00:00.000Z",
"error_message": null,
"created_at": "2025-04-10T09:00:00.000Z"
},
{
"id": "src_def456",
"name": "Shipping policies",
"type": "text",
"status": "ready",
"source_url": null,
"char_count": 3200,
"chunk_count": 5,
"last_synced": "2025-04-10T09:05:00.000Z",
"error_message": null,
"created_at": "2025-04-10T09:05:00.000Z"
}
]
}
}
Response fields
| Field | Type | Description |
|---|---|---|
id | string | Unique ID of the source |
name | string | Descriptive name of the source |
type | string | Source type: url, sitemap, url_list, document, text, faq, woocommerce_catalog, woocommerce_variations, zendesk, google_drive or freshdesk. From the API you can only create url, text and faq; the rest are added from the dashboard |
status | string | Status: pending, processing, ready or error |
source_url | string | null | Source URL (for URL-based sources, such as url or sitemap) |
char_count | integer | Characters indexed |
chunk_count | integer | Chunks generated for vector search |
last_synced | string | Last processing date (ISO 8601) |
error_message | string | null | Error message if status is error |
created_at | string | Creation date (ISO 8601) |
Common errors
| Code | Description |
|---|---|
NOT_FOUND | The agent doesn’t exist or doesn’t belong to your organization |