Добавить заметку
Заметка длиной до 20 000 символов на одном уровне, обычно готовая за секунду-другую.
Выполняет настоящий запрос в вашем рабочем пространстве.
POST /knowledge/notes
Заметка длиной до 20 000 символов на одном уровне, обычно готовая за секунду-другую.
Пример
Требует knowledge:write. title длиной до 200 символов, а body до 20 000, при желании в Markdown. Не передавайте scope для всего рабочего пространства. pinned помещает заметку в каждый промпт на её уровне, до 2 000 символов закреплённых заметок с каждого уровня. Отвечает 201 с заметкой.
curl -X POST "$OE/knowledge/notes" -H "$AUTH" -H "Content-Type: application/json" \ -d '{ "scope": "@acme.com", "title": "Refunds", "body": "Refunds are paid within 14 days of the return reaching our warehouse.", "pinned": true }'{ "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"}Чтобы изменить элемент, нужен доступ к каждому адресу, который охватывает его уровень: всё рабочее пространство требует всех адресов, домен весь домен, а адрес этот адрес. Ключ или приложение, ограниченные определёнными адресами, могут менять элементы только на этих адресах или на доменах, которые они держат целиком.
Уровень, который не является рабочим пространством, одним из его доменов или одним из его адресов, даёт 422 invalid_knowledge_scope, а уровень вне досягаемости ключа 403 knowledge_scope_not_reached. Если отправить один и тот же запрос дважды, добавятся две заметки.