Skip to main content
GET
/
v1
/
knowledge-bases
/
{id}
Get Knowledge Base
curl --request GET \
  --url https://api.example.com/v1/knowledge-bases/{id} \
  --header 'X-API-Key: <x-api-key>'
{
  "success": true,
  "knowledge_base": {
    "knowledge_base_id": "knowledge_base_7a0682ce5fc02413",
    "knowledge_base_name": "Acme Solutions",
    "unique_id": "1764105884537x291772143525964264",
    "status": "complete",
    "total_sources": 2,
    "source_types": ["url", "text"],
    "source_details": {
      "urls": ["https://www.prantanirbarua.dev/"],
      "texts": [
        {
          "title": "Policy",
          "text_length": 131
        }
      ]
    },
    "knowledge_base_sources": [
      {
        "type": "url",
        "source_id": "source_xxx",
        "url": "https://www.prantanirbarua.dev/"
      },
      {
        "type": "text",
        "source_id": "source_yyy",
        "title": "Policy"
      }
    ],
    "enable_auto_refresh": false,
    "last_refreshed_timestamp": null,
    "default_top_k": 3,
    "default_filter_score": 0.6,
    "created_at": "2025-11-25T21:24:44.643602+00:00",
    "updated_at": "2025-11-25T21:24:44.643602+00:00"
  },
  "powered_by": "Teli"
}

​
Authentication

​
X-API-Key
string
required
Your Teli API key

​
Path Parameters

​
id
string
required
Knowledge base ID (knowledge_base_id or unique_id)

​
Request Example

curl "https://api.teli.ai/v1/knowledge-bases/knowledge_base_7a0682ce5fc02413" \
  -H "X-API-Key: YOUR_API_KEY"

​
Response

​
success
boolean
Whether request was successful
​
knowledge_base
object
Knowledge base object with full details
​
powered_by
string
Platform identifier
{
  "success": true,
  "knowledge_base": {
    "knowledge_base_id": "knowledge_base_7a0682ce5fc02413",
    "knowledge_base_name": "Acme Solutions",
    "unique_id": "1764105884537x291772143525964264",
    "status": "complete",
    "total_sources": 2,
    "source_types": ["url", "text"],
    "source_details": {
      "urls": ["https://www.prantanirbarua.dev/"],
      "texts": [
        {
          "title": "Policy",
          "text_length": 131
        }
      ]
    },
    "knowledge_base_sources": [
      {
        "type": "url",
        "source_id": "source_xxx",
        "url": "https://www.prantanirbarua.dev/"
      },
      {
        "type": "text",
        "source_id": "source_yyy",
        "title": "Policy"
      }
    ],
    "enable_auto_refresh": false,
    "last_refreshed_timestamp": null,
    "default_top_k": 3,
    "default_filter_score": 0.6,
    "created_at": "2025-11-25T21:24:44.643602+00:00",
    "updated_at": "2025-11-25T21:24:44.643602+00:00"
  },
  "powered_by": "Teli"
}

​
Status Field

The status field indicates processing state:
  • in_progress: KB is being processed (indexing sources)
  • complete: KB is ready to use
  • error: Processing failed
Check status periodically until complete before linking to agents.