Añadir una nota
Una nota de hasta 20.000 caracteres en un nivel, normalmente lista en un segundo o dos.
Ejecuta la llamada real en tu espacio de trabajo.
POST /knowledge/notes
Una nota de hasta 20.000 caracteres en un nivel, normalmente lista en un segundo o dos.
Ejemplo
Requiere knowledge:write. title tiene hasta 200 caracteres y body hasta 20.000, en Markdown si quieres. Omite scope para todo el espacio de trabajo. pinned mete la nota en cada prompt de su nivel, hasta 2.000 caracteres de notas fijadas por nivel. Responde 201 con la nota.
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"}Cambiar un elemento requiere alcanzar cada dirección que cubre su nivel: todo el espacio de trabajo requiere todas las direcciones, un dominio el dominio entero, y una dirección esa dirección. Una clave o una aplicación limitada a ciertas direcciones solo puede cambiar elementos en esas direcciones, o en dominios que tiene enteros.
Un nivel que no es el espacio de trabajo, uno de sus dominios ni una de sus direcciones es un 422 invalid_knowledge_scope, y uno fuera del alcance de la clave un 403 knowledge_scope_not_reached. Enviar dos veces la misma solicitud añade dos notas.