SMAO API Documentation
Public APIKnowledge items

List knowledge items (paginated)

GET
/knowledge-items

Authorization

bearerAuth
AuthorizationBearer <token>

API key in the Authorization: Bearer <key> header. Keys are created in the SMAO dashboard (Settings → API Keys).

In: header

Query Parameters

cursor?string

Opaque cursor from a prior meta.next_cursor. Base64url-encoded (unpadded) — do not parse or construct it manually.

Match^[A-Za-z0-9_-]+$
limit?integer

Items per page (1–100, default 50).

Range1 <= value <= 100
Default50
group_id?string

Filter by knowledges group.

Match^[a-f0-9]{24}$

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/knowledge-items"
{  "data": [    {      "id": "string",      "group_id": "string",      "name": "string",      "active": true,      "text_length": 5000000,      "sync_status": {        "state": "pending",        "synced_at": "2019-08-24T14:15:22Z",        "total_chunks": 0,        "estimated_duration_ms": 0,        "error": "string"      },      "created_at": "2019-08-24T14:15:22Z",      "updated_at": "2019-08-24T14:15:22Z"    }  ],  "meta": {    "has_more": true,    "next_cursor": "string"  }}

Delete a prompt DELETE

Before deleting, clear both `prompt_id` and `email_prompt_id` references from assistants. The server returns 409 `conflict` when the prompt is still assigned through `prompt_id`; clients must not rely on that guard to detect an `email_prompt_id` reference.

Create a knowledge item POST

Creates a new knowledge item and asynchronously embeds its text for retrieval. `sync_status.state` follows the lifecycle: