List Knowledge Sources

GET/api/v1/knowledge

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

Required scope: read

This endpoint takes no query parameters — it always returns the full list, newest first.

Response

sourcesarray

Array of knowledge source objects.

Example

cURL

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

200 OK:

{
  "sources": [
    {
      "id": "ks-uuid-001",
      "type": "url",
      "name": "https://acme.com/pricing",
      "status": "trained",
      "char_count": 1842,
      "crawl_schedule": "weekly",
      "next_crawl_at": "2026-07-08T09:00:00Z",
      "last_crawled_at": "2026-07-01T09:00:00Z",
      "created_at": "2026-07-01T09:00:00Z"
    },
    {
      "id": "ks-uuid-002",
      "type": "text",
      "name": "Refund Policy",
      "status": "trained",
      "char_count": 612,
      "crawl_schedule": null,
      "next_crawl_at": null,
      "last_crawled_at": null,
      "created_at": "2026-06-28T11:30:00Z"
    }
  ]
}

Clear Session

Add Knowledge