API
リンクを追加する
公開ウェブページ。バックグラウンドで取得して読み取る。
POST/knowledge/links
実際の呼び出しをワークスペースに対して実行します。
POST /knowledge/links
公開ウェブページ。バックグラウンドで取得して読み取る。
例
knowledge:write が必要。url は最大 2,048 文字の公開 http または https アドレスで、https として保存される。title がないと、ページを読み取るまではリンクの名前、その後はページ自身のタイトルが項目名になる。queued のリンクとともに 201 を返す。
curl -X POST "$OE/knowledge/links" -H "$AUTH" -H "Content-Type: application/json" \ -d '{ "url": "https://acme.com/shipping" }'{ "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}非公開またはローカルのホストにあるアドレス、あるいはユーザー名、パスワード、ポートを含むアドレスは 422 invalid_knowledge_url。同じレベルの同じリンクは 409 knowledge_link_exists。
取得できないページは failure: "fetch_failed" 付きの failed で終わる。1 ページから読み取るのは最大 5 MB。