ドキュメント本文へスキップ
API

ナレッジ項目を読み直す

リンクを取得し直す、ファイルを読み直す、またはメモをインデックスし直す。

POST/knowledge/{id}/refresh

実際の呼び出しをワークスペースに対して実行します。

POST /knowledge/{id}/refresh

リンクを取得し直す、ファイルを読み直す、またはメモをインデックスし直す。

例

knowledge:write が必要。失敗を消し、項目を queued に戻す。新しいテキストの準備ができるまで前のテキストが使われる。

curl
curl -X POST "$OE/knowledge/kb_3e7b1d9a4c2f80e6b5a1c47d/refresh" -H "$AUTH"
レスポンス
{  "object": "knowledge_item",  "id": "kb_3e7b1d9a4c2f80e6b5a1c47d",  "kind": "link",  "scope": "",  "level": "workspace",  "title": "https://acme.com/shipping",  "url": "https://acme.com/shipping",  "fileName": null,  "mimeType": null,  "sizeBytes": null,  "pinned": false,  "status": "queued",  "failure": null,  "chunks": 0,  "chars": 0,  "origin": "api",  "createdBy": "usr_5f2a9c71",  "createdAt": "2026-10-08T09:14:02.000Z",  "updatedAt": "2026-10-08T09:14:02.000Z",  "indexedAt": null}

項目を 2 回読み直しても状態は同じなので、再試行しても安全。

リファレンス