Zur Dokumentation springen
API

Einen Link hinzufügen

Eine öffentliche Webseite, im Hintergrund abgerufen und gelesen.

POST/knowledge/links

Führt den echten Aufruf in Ihrem Workspace aus.

POST /knowledge/links

Eine öffentliche Webseite, im Hintergrund abgerufen und gelesen.

Beispiel

Erfordert knowledge:write. url ist eine öffentliche http- oder https-Adresse von höchstens 2.048 Zeichen, gespeichert als https. Ohne title trägt der Eintrag den Namen des Links, bis die Seite gelesen ist, und danach den Titel der Seite selbst. Antwortet 201 mit dem Link, queued.

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

Eine Adresse auf einem privaten oder lokalen Host oder eine mit Benutzername, Passwort oder Port ist ein 422 invalid_knowledge_url. Derselbe Link auf derselben Ebene ist ein 409 knowledge_link_exists.

Eine Seite, die nicht abgerufen werden kann, endet als failed mit failure: "fetch_failed". Von einer Seite werden höchstens 5 MB gelesen.

Referenz