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

ナレッジ項目を一覧表示する

ナレッジベースの項目を新しい順に、1 ページずつ。

GET/knowledge

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

GET /knowledge

ナレッジベースの項目を新しい順に、1 ページずつ。

例

knowledge:read が必要。フィルターはどれも任意。scope は 1 つのレベル、level はレベルの種類(workspace、domain、address)、kind はメモ、ファイル、リンク、status は 1 つの状態、pinned はピン留めしたメモに絞り、q はタイトル、ファイル名、リンク中の語句と照合する。limit は最大 100 で既定は 50、cursor には前のページの nextCursor を渡す。

curl
curl "$OE/knowledge?level=domain&limit=20" -H "$AUTH"
レスポンス
{  "object": "list",  "data": [{      "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"    }],  "hasMore": false,  "nextCursor": null}

特定のアドレスに限定されたキーやアプリには、ワークスペース全体の項目と、そのアドレスとそのドメインの項目が見える。見えないレベルを指定すると何も返らない。

この一覧が渡していないカーソルは 400 invalid_cursor。

リファレンス