API
Change a knowledge item
Its title, the text of a note, the page of a link, its level or whether a note is pinned.
PATCH/knowledge/{id}
Runs the real call on your workspace.
PATCH /knowledge/{id}
Its title, the text of a note, the page of a link, its level or whether a note is pinned.
Example
Needs knowledge:write. Give at least one of title, body, scope, pinned and url. A changed title, text or link is read again, and the previous text stays in use until the new one is ready. Moving an item needs reach at both levels.
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 or pinned on anything but a note is a 422 knowledge_not_a_note, and url on anything but a link a 422 knowledge_not_a_link.