Skip to the documentation
API

Get a knowledge item

One item with its text.

GET/knowledge/{id}

Runs the real call on your workspace.

GET /knowledge/{id}

One item with its text.

Example

Needs knowledge:read. body is the text of a note. preview is the first 20,000 characters read from a file or a page, null until it has been read, and previewTruncated says whether the text goes on.

curl
curl "$OE/knowledge/kb_8c1f4a2b9d7e3f60a5c7b21d" -H "$AUTH"
Response
{  "object": "knowledge_item",  "id": "kb_8c1f4a2b9d7e3f60a5c7b21d",  "kind": "note",  "scope": "@acme.com",  "level": "domain",  "title": "Refunds",  "url": null,  "fileName": null,  "mimeType": null,  "sizeBytes": null,  "pinned": true,  "status": "ready",  "failure": null,  "chunks": 1,  "chars": 71,  "origin": "api",  "createdBy": "usr_5f2a9c71",  "createdAt": "2026-10-08T09:12:44.000Z",  "updatedAt": "2026-10-08T09:12:44.000Z",  "indexedAt": "2026-10-08T09:12:45.000Z",  "body": "Refunds are paid within 14 days of the return reaching our warehouse.",  "preview": "Refunds are paid within 14 days of the return reaching our warehouse.",  "previewTruncated": false}

An unknown id, and an item at a level the key cannot see, answer 404 knowledge_not_found.

Reference