افزودن یادداشت
یادداشتی تا 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. فرستادن یک درخواست برای دو بار، دو یادداشت اضافه می‌کند.