Belgelere geç
API

Not ekle

Tek bir seviyede en fazla 20.000 karakterlik bir not, genellikle bir iki saniye içinde hazır.

POST/knowledge/notes

Gerçek çağrıyı çalışma alanınızda çalıştırır.

POST /knowledge/notes

Tek bir seviyede en fazla 20.000 karakterlik bir not, genellikle bir iki saniye içinde hazır.

Örnek

knowledge:write gerektirir. title en fazla 200 karakter, body en fazla 20.000 karakterdir; isterseniz Markdown ile. Tüm çalışma alanı için scope göndermeyin. pinned notu kendi seviyesindeki her isteme koyar; her seviyeden en fazla 2.000 karakter sabitlenmiş not. Notla birlikte 201 döner.

curl
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 }'
Yanıt
{  "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"}

Bir öğeyi değiştirmek, seviyesinin kapsadığı her adrese erişim gerektirir: tüm çalışma alanı her adresi, bir alan adı alan adının tamamını, bir adres de o adresi gerektirir. Belirli adreslerle sınırlı bir anahtar ya da uygulama, öğeleri yalnızca o adreslerde ya da tamamını tuttuğu alan adlarında değiştirebilir.

Çalışma alanı, alan adlarından biri ya da adreslerinden biri olmayan bir seviye 422 invalid_knowledge_scope, anahtarın erişiminin dışındaki bir seviye ise 403 knowledge_scope_not_reached olur. Aynı isteği iki kez göndermek iki not ekler.

Referans