Aller à la documentation
API

Ajouter un lien

Une page web publique, récupérée et lue en arrière-plan.

POST/knowledge/links

Exécute le véritable appel sur votre espace de travail.

POST /knowledge/links

Une page web publique, récupérée et lue en arrière-plan.

Exemple

Nécessite knowledge:write. url est une adresse http ou https publique de 2 048 caractères au plus, conservée en https. Sans title, l'élément porte le nom du lien jusqu'à ce que la page soit lue, puis le titre de la page elle-même. Répond 201 avec le lien, queued.

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

Une adresse sur un hôte privé ou local, ou avec un nom d'utilisateur, un mot de passe ou un port, est une 422 invalid_knowledge_url. Le même lien au même niveau est une 409 knowledge_link_exists.

Une page qui ne peut pas être récupérée finit en failed avec failure: "fetch_failed". Au plus 5 Mo d'une page sont lus.

Référence