Plan limits
Create an article
Send aPOST request to /api/v1/kb/articles with the article details.
Request body
List articles
Retrieve all articles for your workspace:Delete an article
Remove an article by its ID:{"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.