Public APIKnowledge items
Get a knowledge item (with full text)
GET
bearerAuthheader
AuthorizationBearer <token>API key in the Authorization: Bearer <key> header.
Keys are created in the Hallolara dashboard (Settings → API Keys).
knowledge_item_id*stringMatch
^[a-f0-9]{24}$The knowledge item.
application/json- response
data?Summary shape - text is omitted; use the detail endpoint for full body.
curl -X GET 'https://api.hallolara.ai/api/v1/knowledge-items/65f8fa6f1a9d8e0012ab34cd'Example Response
{ "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", "text": "string" }}Create a knowledge item POST
Creates a new knowledge item and asynchronously embeds its text for retrieval. `sync_status.state` follows the lifecycle:
Update a knowledge item PATCH
Every update currently re-indexes the item, including changes limited to `name`, `group_id`, or `active`. `sync_status.state` resets to `pending` and follows the same lifecycle as a fresh create: