Перейти к документации
API

Список элементов базы знаний

Элементы базы знаний, сначала новые, по странице за раз.

GET/knowledge

Выполняет настоящий запрос в вашем рабочем пространстве.

GET /knowledge

Элементы базы знаний, сначала новые, по странице за раз.

Пример

Требует knowledge:read. Все фильтры необязательны: scope оставляет один уровень, level один вид уровня (workspace, domain или address), kind заметки, файлы или ссылки, status один статус, pinned закреплённые заметки, а q сравнивает слова в заголовке, имени файла или ссылке. limit доходит до 100 и по умолчанию равен 50, а cursor принимает nextCursor предыдущей страницы.

curl
curl "$OE/knowledge?level=domain&limit=20" -H "$AUTH"
Ответ
{  "object": "list",  "data": [{      "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"    }],  "hasMore": false,  "nextCursor": null}

Ключ или приложение, ограниченные определёнными адресами, видят элементы всего рабочего пространства и элементы своих адресов и их доменов. Уровень, который они не видят, ничего не выводит.

Курсор, который этот список не выдавал, даёт 400 invalid_cursor.

Справочник