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

Изменить элемент базы знаний

Его заголовок, текст заметки, страницу ссылки, его уровень или то, закреплена ли заметка.

PATCH/knowledge/{id}

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

PATCH /knowledge/{id}

Его заголовок, текст заметки, страницу ссылки, его уровень или то, закреплена ли заметка.

Пример

Требует knowledge:write. Передайте хотя бы одно из title, body, scope, pinned и url. Изменённый заголовок, текст или ссылка читаются заново, а прежний текст используется, пока новый не будет готов. Чтобы перенести элемент, нужен доступ к обоим уровням.

curl
curl -X PATCH "$OE/knowledge/kb_8c1f4a2b9d7e3f60a5c7b21d" -H "$AUTH" \  -H "Content-Type: application/json" -d '{ "scope": "" }'
Ответ
{  "object": "knowledge_item",  "id": "kb_8c1f4a2b9d7e3f60a5c7b21d",  "kind": "note",  "scope": "",  "level": "workspace",  "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 или pinned у чего-либо, кроме заметки, даёт 422 knowledge_not_a_note, а url у чего-либо, кроме ссылки, 422 knowledge_not_a_link.

Справочник