Ajouter une note
Une note de jusqu'à 20 000 caractères à un niveau, en général prête en une seconde ou deux.
Exécute le véritable appel sur votre espace de travail.
POST /knowledge/notes
Une note de jusqu'à 20 000 caractères à un niveau, en général prête en une seconde ou deux.
Exemple
Nécessite knowledge:write. title fait jusqu'à 200 caractères et body jusqu'à 20 000, en Markdown si vous le souhaitez. Omettez scope pour tout l'espace de travail. pinned met la note dans chaque prompt à son niveau, jusqu'à 2 000 caractères de notes épinglées par niveau. Répond 201 avec la note.
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"}Modifier un élément demande d'atteindre chaque adresse que couvre son niveau : tout l'espace de travail demande toutes les adresses, un domaine le domaine entier, et une adresse cette adresse. Une clé ou une application limitée à certaines adresses ne peut modifier des éléments qu'à ces adresses, ou aux domaines qu'elle détient en entier.
Un niveau qui n'est ni l'espace de travail, ni l'un de ses domaines, ni l'une de ses adresses est une 422 invalid_knowledge_scope, et un niveau hors de portée de la clé une 403 knowledge_scope_not_reached. Envoyer deux fois la même requête ajoute deux notes.