Перейти к документации
API

Добавить ссылку

Публичная веб-страница, загружаемая и читаемая в фоне.

POST/knowledge/links

Выполняет настоящий запрос в вашем рабочем пространстве.

POST /knowledge/links

Публичная веб-страница, загружаемая и читаемая в фоне.

Пример

Требует knowledge:write. url это публичный адрес http или https длиной не больше 2 048 символов, сохраняемый как https. Без title элемент называется по ссылке, пока страница не прочитана, а потом по заголовку самой страницы. Отвечает 201 со ссылкой в статусе queued.

curl
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.

Страница, которую не удаётся загрузить, заканчивается в failed с failure: "fetch_failed". Со страницы читается не больше 5 МБ.

Справочник