Returns all knowledge base articles belonging to your organization, ordered by most recently created first.
Method: GET URL: /api/v1/kb/articles
| Header | Value |
|---|
| Authorization | Bearer |
Response
Unique integer ID of the article.
ID of the business that owns this article.
Title of the knowledge base article.
Full text content of the article.
Array of tag strings associated with the article.
ISO 8601 timestamp of when the article was created.
Example
curl --request GET \
--url https://api.pingback.live/api/v1/kb/articles \
--header 'Authorization: Bearer {token}'
Response example
[
{
"id": 42,
"business_id": 7,
"title": "How to reset your password",
"content": "To reset your password, click the 'Forgot Password' link on the login page...",
"tags": ["account", "password", "security"],
"created_at": "2024-01-18T10:00:00Z"
},
{
"id": 41,
"business_id": 7,
"title": "Billing and subscription FAQ",
"content": "We accept all major credit cards. Your subscription renews monthly...",
"tags": ["billing", "subscription"],
"created_at": "2024-01-15T09:30:00Z"
}
]
Delete an article
Method: DELETE URL: /api/v1/kb/articles/{article_id}
Permanently removes a knowledge base article from your organization. The article is also deleted from the semantic search index, so it will no longer be referenced by Theo AI in conversations.
Deletion is permanent and cannot be undone. The article will be removed from the AI’s knowledge base immediately.
Path parameters
The integer ID of the article to delete.
Example
curl --request DELETE \
--url https://api.pingback.live/api/v1/kb/articles/42 \
--header 'Authorization: Bearer {token}'
Response example
{ "message": "Article deleted" }
Errors
| Status | Meaning |
|---|
| 401 | Unauthorized — missing or invalid token |
| 404 | Article not found |