API
メモを追加する
1 つのレベルに置く最大 20,000 文字のメモ。たいてい 1、2 秒で使えるようになる。
POST/knowledge/notes
実際の呼び出しをワークスペースに対して実行します。
POST /knowledge/notes
1 つのレベルに置く最大 20,000 文字のメモ。たいてい 1、2 秒で使えるようになる。
例
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。同じリクエストを 2 回送るとメモが 2 つ追加される。