Skip to main content
Knowledge Bases store files and URLs that an agent can search during calls through RAG.

​
Availability

These endpoints require Knowledge Base to be available for the organization. When it is not, every Knowledge Base endpoint returns 403 forbidden with { "error": "forbidden" }. Availability is controlled by Telzino and your partner account — it cannot be set through the API. Organization creation does not accept a Knowledge Base field, and there is no organization update endpoint. You can, however, check availability before you call these endpoints, so a 403 never comes as a surprise: GET /v1/features?organization_id=… reports whether knowledge_base is available or locked for the organization, and whether the lock was placed on the organization itself or inherited from its reseller or account. Use it to hide the feature rather than surfacing a failed request. If these endpoints return 403 forbidden, enable Knowledge Base for the organization in the Telzino Dashboard under its feature settings, or contact Telzino support if that option is not available to you.

​
Workflow

  1. Create or list knowledge bases for an organization.
  2. Add sources to a knowledge base.
  3. For file sources, upload the file to the returned presigned URL, then enqueue ingestion.
  4. Assign the knowledge base to an agent — either inline with Create Agent (ragEnabled + knowledgeBaseId), or afterwards with Update Agent.
  5. When a source’s content changes later, refresh it — indexing does not repeat on its own.
To read a stored file back, use Download a Source File.

​
Keeping Content Current

A source is indexed once, when you add it — nothing re-crawls or re-reads it on a schedule. When a page or document changes afterwards, the agent keeps answering from the version that was indexed until you trigger a refresh. See Refreshing Content for how to re-index a knowledge base and how to replace an updated document.

​
Endpoints

​
Supported Files

File sources support PDF, DOCX, TXT, HTML, CSV, and Markdown up to 50 MB.