Skip to main content
Creates a new knowledge base article for your organization. After creation, the article is automatically indexed for semantic search so Theo AI can reference it when responding to customer conversations. Method: POST URL: /api/v1/kb/articles
Articles are automatically embedded and indexed into Theo AI’s vector search. This happens asynchronously — if indexing fails, the article is still saved and you can recreate it to retry indexing.

​
Plan limits

PlanMax articles
Free5
Mini25
Pro1,000

​
Headers

HeaderValue
AuthorizationBearer
Content-Typeapplication/json

​
Body

​
title
string
required
The title of the article. Used as context when Theo AI performs semantic search.
​
content
string
required
The full text content of the article. Write this in plain language — the AI reads it as-is to answer customer questions.
​
tags
string[]
default:"[]"
Optional array of tag strings to categorize the article (e.g., ["billing", "refunds"]).

​
Response

​
id
integer
required
Unique integer ID of the created article.
​
business_id
integer
required
ID of the business that owns the article.
​
title
string
required
Title of the article.
​
content
string
required
Full text content of the article.
​
tags
string[]
required
Array of tags associated with the article.
​
created_at
string
required
ISO 8601 timestamp of when the article was created.

​
Example

curl --request POST \
  --url https://api.pingback.live/api/v1/kb/articles \
  --header 'Authorization: Bearer {token}' \
  --header 'Content-Type: application/json' \
  --data '{
    "title": "How to cancel your subscription",
    "content": "You can cancel your subscription at any time from the Billing page in your account settings. Cancellations take effect at the end of the current billing period. No refunds are issued for partial months.",
    "tags": ["billing", "cancellation", "subscription"]
  }'

const response = await fetch('https://api.pingback.live/api/v1/kb/articles', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer {token}',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    title: 'How to cancel your subscription',
    content: 'You can cancel your subscription at any time from the Billing page in your account settings. Cancellations take effect at the end of the current billing period. No refunds are issued for partial months.',
    tags: ['billing', 'cancellation', 'subscription']
  })
});

const article = await response.json();

​
Response example

{
  "id": 43,
  "business_id": 7,
  "title": "How to cancel your subscription",
  "content": "You can cancel your subscription at any time from the Billing page in your account settings. Cancellations take effect at the end of the current billing period. No refunds are issued for partial months.",
  "tags": ["billing", "cancellation", "subscription"],
  "created_at": "2024-01-20T15:45:00Z"
}

​
Errors

StatusMeaning
400User does not belong to an organization
401Unauthorized — missing or invalid token
402Article limit reached — upgrade your plan to add more articles