Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.pingback.live/llms.txt

Use this file to discover all available pages before exploring further.

Returns all knowledge base articles belonging to your organization, ordered by most recently created first. Method: GET URL: /api/v1/kb/articles

​
Headers

HeaderValue
AuthorizationBearer

​
Response

​
id
integer
required
Unique integer ID of the article.
​
business_id
integer
required
ID of the business that owns this article.
​
title
string
required
Title of the knowledge base article.
​
content
string
required
Full text content of the article.
​
tags
string[]
required
Array of tag strings associated with the article.
​
created_at
string
required
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

​
article_id
integer
required
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

StatusMeaning
401Unauthorized — missing or invalid token
404Article not found