List knowledge items
bearerAuthAuthorizationBearer <token>API key in the Authorization: Bearer <key> header.
Keys are created in the Hallolara dashboard (Settings → API Keys).
cursor?stringOpaque cursor from a prior meta.next_cursor. Base64url-encoded
(unpadded) - do not parse or construct it manually. A value that is not
base64url is rejected with validation_failed, and so is a
/phone-numbers cursor without a phone number; any other value that does
not decode to a list position (a timestamp and a row id) restarts at the
first page.
^[A-Za-z0-9_-]+$limit?integerItems per page (1–100, default 50).
1 <= value <= 10050group_id?stringFilter by knowledges group.
^[a-f0-9]{24}$Page of knowledge items.
application/json- response
data*array<>meta*curl -X GET 'https://api.hallolara.ai/api/v1/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 the `prompt_id` and `outbound_prompt_id` references from every assistant that uses the prompt. The server returns 409 `conflict` while the prompt is still assigned in either place.
Create a knowledge item POST
Creates a new knowledge item and asynchronously embeds its text for retrieval. `sync_status.state` follows the lifecycle: