Overview
Knowledge bases are collections of documents and text that Sendora’s AI voice agents retrieve from in real time during a call. When a prospect asks “What’s your pricing?” or “Do you integrate with Salesforce?”, the agent searches the relevant KB and answers accurately instead of hallucinating. KBs support two source types via the API:- Text, paste in raw content (FAQs, product sheets, objection handlers)
- URL, provide a web page URL and Sendora crawls and indexes it automatically
Creating a knowledge base
id you’ll use to add sources and assign it to agents.
Reading knowledge bases
sources array:
status values: pending, indexing, ready, error. Lists accept page and limit and report X-Total-Count, X-Page and X-Per-Page.
Adding sources
Add sources withadd_sources on Update knowledge base. Each source is text or url.
status before the agent goes live.
Editing and removing sources
GET /knowledge-bases?id=KB_ID&source_id=SOURCE_ID to get its content, its indexing_version and its last synced snapshot. expected_version is the version of the source you last read; if someone else has changed it since, the edit is refused so two edits cannot overwrite each other. Removing a source deletes it and all its chunks from the index; the knowledge base stays active. For a source that syncs from a connected app, restore_snapshots (a list of source_id and expected_version) puts the last synced copy back as the working copy, and accept_provider_updates makes a synced update the working copy.
The steps run in this order: name and description, sources added, sources edited, snapshots restored, provider updates accepted, sources removed. If one fails, the earlier steps stay applied and the error lists them under applied.
Assigning a KB to a voice agent
A knowledge base becomes available to an agent when you assign it, withknowledge_base_ids on Update agent: