Saltar para a documentação
API

Alterar um item de conhecimento

O seu título, o texto de uma nota, a página de uma ligação, o seu nível ou se uma nota está afixada.

PATCH/knowledge/{id}

Executa a chamada real no seu espaço de trabalho.

PATCH /knowledge/{id}

O seu título, o texto de uma nota, a página de uma ligação, o seu nível ou se uma nota está afixada.

Exemplo

Requer knowledge:write. Indique pelo menos um de title, body, scope, pinned e url. Um título, texto ou ligação alterado é lido de novo, e o texto anterior continua em uso até o novo estar pronto. Mover um item requer alcance em ambos os níveis.

curl
curl -X PATCH "$OE/knowledge/kb_8c1f4a2b9d7e3f60a5c7b21d" -H "$AUTH" \  -H "Content-Type: application/json" -d '{ "scope": "" }'
Resposta
{  "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 ou pinned em algo que não seja uma nota é um 422 knowledge_not_a_note, e url em algo que não seja uma ligação um 422 knowledge_not_a_link.

Referência