Saltar para a documentação
API

Adicionar uma ligação

Uma página web pública, obtida e lida em segundo plano.

POST/knowledge/links

Executa a chamada real no seu espaço de trabalho.

POST /knowledge/links

Uma página web pública, obtida e lida em segundo plano.

Exemplo

Requer knowledge:write. url é um endereço http ou https público com 2.048 caracteres no máximo, guardado como https. Sem title, o item tem o nome da ligação até a página ser lida, e depois o título da própria página. Responde 201 com a ligação, queued.

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

Um endereço num anfitrião privado ou local, ou com nome de utilizador, palavra-passe ou porta, é um 422 invalid_knowledge_url. A mesma ligação no mesmo nível é um 409 knowledge_link_exists.

Uma página que não pode ser obtida termina em failed com failure: "fetch_failed". São lidos no máximo 5 MB de uma página.

Referência