C
Chatty

List Knowledge Sources

GET/api/v1/knowledge

Returns all knowledge sources (text snippets, crawled URLs, uploaded documents) that the bot uses when answering questions.

Required scope: read

Query parameters

limitintegerquerydefault: 50
Number of sources to return. Max 200.
offsetintegerquerydefault: 0
Zero-based offset for pagination.

Response

sourcesarray

Array of knowledge source objects.

totalinteger
Total number of sources for this bot.

Example

cURL
curl "https://api.personaliai.com/api/v1/knowledge" \
  -H "Authorization: Bearer chatty_sk_your_key"

200 OK:

{
  "sources": [
    {
      "id": "ks-uuid-001",
      "bot_id": "a1b2c3d4-...",
      "type": "url",
      "title": "https://acme.com/pricing",
      "content_preview": "Acme Corp Pricing — Starter: $29/mo, Pro: $99/mo, Enterprise: custom...",
      "status": "ready",
      "created_at": "2026-07-01T09:00:00Z"
    },
    {
      "id": "ks-uuid-002",
      "bot_id": "a1b2c3d4-...",
      "type": "text",
      "title": "Refund Policy",
      "content_preview": "All purchases are eligible for a full refund within 30 days...",
      "status": "ready",
      "created_at": "2026-06-28T11:30:00Z"
    }
  ],
  "total": 2
}