Ir a la documentación
API

Añadir un enlace

Una página web pública, que se obtiene y se lee en segundo plano.

POST/knowledge/links

Ejecuta la llamada real en tu espacio de trabajo.

POST /knowledge/links

Una página web pública, que se obtiene y se lee en segundo plano.

Ejemplo

Requiere knowledge:write. url es una dirección http o https pública de 2.048 caracteres como máximo, guardada como https. Sin title, el elemento lleva el nombre del enlace hasta que se lee la página, y después el título de la propia página. Responde 201 con el enlace, queued.

curl
curl -X POST "$OE/knowledge/links" -H "$AUTH" -H "Content-Type: application/json" \  -d '{ "url": "https://acme.com/shipping" }'
Respuesta
{  "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}

Una dirección en un host privado o local, o con nombre de usuario, contraseña o puerto, es un 422 invalid_knowledge_url. El mismo enlace en el mismo nivel es un 409 knowledge_link_exists.

Una página que no se puede obtener termina en failed con failure: "fetch_failed". Se leen como mucho 5 MB de una página.

Referencia