Add knowledge source

curl --request POST \
  --url http://localhost:8787/api/v1/knowledge-bases/{id}/sources \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "sourceType": "<string>",
  "sourceName": "<string>"
}
'

import requests

url = "http://localhost:8787/api/v1/knowledge-bases/{id}/sources"

payload = {
    "sourceType": "<string>",
    "sourceName": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({sourceType: '<string>', sourceName: '<string>'})
};

fetch('http://localhost:8787/api/v1/knowledge-bases/{id}/sources', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

POST

knowledge-bases

{id}

sources

Add knowledge source

curl --request POST \
  --url http://localhost:8787/api/v1/knowledge-bases/{id}/sources \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "sourceType": "<string>",
  "sourceName": "<string>"
}
'

import requests

url = "http://localhost:8787/api/v1/knowledge-bases/{id}/sources"

payload = {
    "sourceType": "<string>",
    "sourceName": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({sourceType: '<string>', sourceName: '<string>'})
};

fetch('http://localhost:8787/api/v1/knowledge-bases/{id}/sources', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

Adds a new document or text knowledge source to an existing knowledge base. The platform automatically breaks the text into chunks, generates vector embeddings, and indexes them for RAG retrieval during agent calls.

Path parameters

string

required

UUID of the target knowledge base

Body parameters

string

required

Type of the source — text, url, or file

string

required

Human-readable title (e.g. Refund Policy 2026 or Company FAQ)

string

The text content to ingest (required when sourceType is text)

string

The webpage URL to scrape and index (required when sourceType is url)

curl -X POST https://api.agentic-os.com/api/v1/knowledge-bases/KB_ID/sources \
  -H "Authorization: Bearer $AGENTIC_OS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sourceType": "text",
    "sourceName": "Product Pricing & Terms",
    "rawText": "Our basic plan starts at $49/mo and includes 500 voice minutes. Enterprise plans include custom LLM fine-tuning and dedicated support."
  }'

import os, requests

resp = requests.post(
    "https://api.agentic-os.com/api/v1/knowledge-bases/KB_ID/sources",
    headers={
        "Authorization": f"Bearer {os.environ['AGENTIC_OS_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "sourceType": "text",
        "sourceName": "Product Pricing & Terms",
        "rawText": "Our basic plan starts at $49/mo and includes 500 voice minutes. Enterprise plans include custom LLM fine-tuning and dedicated support.",
    },
)
print(resp.json())

await fetch("https://api.agentic-os.com/api/v1/knowledge-bases/KB_ID/sources", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.AGENTIC_OS_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    sourceType: "text",
    sourceName: "Product Pricing & Terms",
    rawText: "Our basic plan starts at $49/mo and includes 500 voice minutes. Enterprise plans include custom LLM fine-tuning and dedicated support.",
  }),
});

Response

{
  "id": "source_789012",
  "knowledgeBaseId": "kb_123456",
  "sourceName": "Product Pricing & Terms",
  "sourceType": "text",
  "status": "PROCESSING",
  "createdAt": "2026-08-15T12:00:00.000Z"
}

⌘I

Overview

Account

Integrations

Configuration

Agents

Numbers

Calls

Campaigns

Knowledge Bases

WhatsApp

Logs

Analytics

Add knowledge source

Path parameters

Body parameters

Response

​Path parameters

​Body parameters

​Response

Path parameters

Body parameters

Response