Skip to main content
Knowledge Bases store files and URLs that an agent can search during calls through RAG. RAG access is gated at two levels:
  • The account must have Knowledge Base (RAG) enabled.
  • The organization must have Knowledge Base (RAG) enabled.
If either gate is disabled, RAG endpoints return 403 forbidden.

​
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 with Update Agent.
  5. Enable ragEnabled for that agent.

​
Endpoints

EndpointPurpose
GET /v1/organizations/{organization_id}/knowledge-basesList knowledge bases
POST /v1/organizations/{organization_id}/knowledge-basesCreate a knowledge base
PUT /v1/knowledge-bases/{knowledgeBaseId}Rename/update a knowledge base
DELETE /v1/knowledge-bases/{knowledgeBaseId}Delete a knowledge base
GET /v1/knowledge-bases/{knowledgeBaseId}/sourcesList sources
POST /v1/knowledge-bases/{knowledgeBaseId}/sourcesCreate a URL or file source
POST /v1/knowledge-sources/{sourceId}/enqueueEnqueue file ingestion after upload
POST /v1/knowledge-sources/{sourceId}/reingestRe-ingest a source
DELETE /v1/knowledge-sources/{sourceId}Delete a source
GET /v1/rag/jobs/{jobId}Poll ingestion job status

​
Supported Files

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