API
افزودن پیوند
یک صفحهٔ وب عمومی که در پسزمینه گرفته و خوانده میشود.
POST/knowledge/links
فراخوانی واقعی را روی فضای کاری شما اجرا میکند.
POST /knowledge/links
یک صفحهٔ وب عمومی که در پسزمینه گرفته و خوانده میشود.
نمونه
به knowledge:write نیاز دارد. url یک نشانی عمومی http یا https با حداکثر 2,048 نویسه است که بهصورت 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 تمام میشود. از هر صفحه حداکثر 5 MB خوانده میشود.