إضافة ملاحظة
ملاحظة تصل إلى 20,000 حرف في مستوى واحد، جاهزة غالبًا خلال ثانية أو ثانيتين.
ينفّذ الاستدعاء الحقيقي على مساحة عملك.
POST /knowledge/notes
ملاحظة تصل إلى 20,000 حرف في مستوى واحد، جاهزة غالبًا خلال ثانية أو ثانيتين.
مثال
يتطلب 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. إرسال الطلب نفسه مرتين يضيف ملاحظتين.