Skip to main content
The knowledge base is a collection of articles your team writes about your product, policies, and common support topics. When Theo generates a reply, it searches your articles using semantic vector search to find the most relevant content and incorporate it into its response. The more complete and accurate your articles are, the better Theo’s replies will be.

Plan limits

Create an article

Send a POST request to /api/v1/kb/articles with the article details.

Request body

List articles

Retrieve all articles for your workspace:
The response is an array of article objects ordered by creation date, newest first.

Delete an article

Remove an article by its ID:
A successful deletion returns {"message": "Article deleted"}.

Best practices for writing articles

Well-written articles directly improve Theo’s reply quality. Keep the following in mind when building your knowledge base:
  • Use clear, specific titles. A title like “How to cancel a subscription” helps Theo match articles to the right questions. Vague titles like “Billing” are harder to match precisely.
  • Write complete answers, not bullet fragments. Theo works best when your content reads as a full explanation. Include the steps, the context, and any common edge cases in the article body.
  • Use tags to categorize by topic. Tags like "billing", "account", and "shipping" make it easier to manage articles as your knowledge base grows.
  • Keep each article focused on a single topic. One article per question or task makes retrieval more accurate than combining multiple topics in one place.
The more detailed your articles, the better Theo’s replies will be. A one-sentence article is rarely enough — aim for a thorough answer that a customer could act on without further questions.