Skip to main content
GET
/
v1
/
knowledge-bases
List Knowledge Bases
curl --request GET \
  --url https://api.example.com/v1/knowledge-bases \
  --header 'X-API-Key: <x-api-key>'
{
  "success": true,
  "count": 1,
  "knowledge_bases": [
    {
      "knowledge_base_id": "knowledge_base_7a0682ce5fc02413",
      "knowledge_base_name": "Acme Solutions",
      "unique_id": "1764105884537x291772143525964264",
      "status": "in_progress",
      "total_sources": 2,
      "source_types": ["url", "text"],
      "source_details": {
        "urls": ["https://www.prantanirbarua.dev/"],
        "texts": [
          {
            "title": "Policy",
            "text_length": 131
          }
        ]
      },
      "enable_auto_refresh": false,
      "default_top_k": 3,
      "default_filter_score": 0.6,
      "organization_id": "4d051118-c116-4923-8ff4-1a9761115fec",
      "tenant_id": "your_tenant_id",
      "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

​
Query Parameters

​
organization_id
string
required
Organization unique_id to list KBs for
​
user_id
string
required
User unique_id (for filtering if not admin)
​
is_admin
boolean
If true, returns all KBs for organization. If false, returns only user’s KBs. Default: false

​
Request Example

curl "https://api.teli.ai/v1/knowledge-bases?organization_id=1762896364768x389173798861431550&user_id=1762896366429x599348279945132448&is_admin=true" \
  -H "X-API-Key: YOUR_API_KEY"

​
Response

​
success
boolean
Whether request was successful
​
knowledge_bases
array
Array of knowledge base objects
​
count
number
Number of knowledge bases returned
​
powered_by
string
Platform identifier (“Teli”)

​
Knowledge Base Object Fields

​
knowledge_base_id
string
Unique KB identifier (use this to link to agents)
​
knowledge_base_name
string
KB name
​
status
string
Processing status: in_progress, complete, or error
​
total_sources
number
Total number of sources (URLs + texts + files)
​
source_types
array
Types of sources: ["url", "text", "document"]
​
source_details
object
Summary of sources with URLs list and text snippet info
​
enable_auto_refresh
boolean
Whether auto-refresh is enabled for URLs
​
default_top_k
number
Default chunks to retrieve (1-10)
​
default_filter_score
number
Default similarity threshold (0-1)
{
  "success": true,
  "count": 1,
  "knowledge_bases": [
    {
      "knowledge_base_id": "knowledge_base_7a0682ce5fc02413",
      "knowledge_base_name": "Acme Solutions",
      "unique_id": "1764105884537x291772143525964264",
      "status": "in_progress",
      "total_sources": 2,
      "source_types": ["url", "text"],
      "source_details": {
        "urls": ["https://www.prantanirbarua.dev/"],
        "texts": [
          {
            "title": "Policy",
            "text_length": 131
          }
        ]
      },
      "enable_auto_refresh": false,
      "default_top_k": 3,
      "default_filter_score": 0.6,
      "organization_id": "4d051118-c116-4923-8ff4-1a9761115fec",
      "tenant_id": "your_tenant_id",
      "created_at": "2025-11-25T21:24:44.643602+00:00",
      "updated_at": "2025-11-25T21:24:44.643602+00:00"
    }
  ],
  "powered_by": "Teli"
}

​
Use Cases

​
View All KBs

GET /v1/knowledge-bases?organization_id=xxx&user_id=xxx&is_admin=true
→ Returns all KBs for organization

​
View User’s KBs Only

GET /v1/knowledge-bases?organization_id=xxx&user_id=xxx&is_admin=false
→ Returns only KBs created by this user