List Sources
List all knowledge sources for an agent.
GET
/knowledge/listGet all knowledge sources attached to an agent.
Query Parameters
Agent ID (format: ag_*)
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
agent_id | string | Yes | The agent's public ID (ag_*) |
Response 200
{
"sources": [
{
"id": 1,
"name": "Product FAQ",
"type": "text",
"status": "ready",
"char_count": 4500,
"chunk_count": 12,
"created_at": "2026-03-01T10:00:00Z"
},
{
"id": 2,
"name": "https://docs.example.com",
"type": "url",
"status": "processing",
"char_count": null,
"chunk_count": null,
"created_at": "2026-03-07T14:00:00Z"
},
{
"id": 3,
"name": "manual.pdf",
"type": "file",
"status": "ready",
"char_count": 28000,
"chunk_count": 85,
"created_at": "2026-03-05T09:00:00Z"
}
]
}Response Fields
| Field | Type | Description |
|---|---|---|
sources[].id | integer | Source ID |
sources[].name | string | Source name or URL |
sources[].type | string | Source type (see Source Types) |
sources[].status | string | processing, ready, failed |
sources[].char_count | integer | null | Total characters indexed |
sources[].chunk_count | integer | null | Number of vector chunks |
sources[].created_at | string | ISO 8601 creation timestamp |
Source Types
| Type | Description |
|---|---|
text | Raw text content |
url | Web page (crawled) |
file | Uploaded document (PDF, DOCX, TXT) |
csv | CSV data |
json | JSON data |
markdown | Markdown document |
youtube | YouTube video transcript |
excel | Excel spreadsheet |
github_repo | GitHub repository |
azure_blob | Azure Blob Storage |
sharepoint | SharePoint document |
ocr | OCR-processed document |
Errors
| Code | Description |
|---|---|
401 | Missing or invalid authentication |
404 | Agent not found |