Aller à la documentation
API

Lister les éléments de connaissance

Les éléments de la base de connaissances, les plus récents en premier, une page à la fois.

GET/knowledge

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

GET /knowledge

Les éléments de la base de connaissances, les plus récents en premier, une page à la fois.

Exemple

Nécessite knowledge:read. Chaque filtre est facultatif : scope garde un niveau, level un type de niveau (workspace, domain ou address), kind les notes, fichiers ou liens, status un état, pinned les notes épinglées, et q compare des mots du titre, du nom de fichier ou du lien. limit va jusqu'à 100 et vaut 50 par défaut, et cursor prend le nextCursor de la page précédente.

curl
curl "$OE/knowledge?level=domain&limit=20" -H "$AUTH"
Réponse
{  "object": "list",  "data": [{      "object": "knowledge_item",      "id": "kb_8c1f4a2b9d7e3f60a5c7b21d",      "kind": "note",      "scope": "@acme.com",      "level": "domain",      "title": "Refunds",      "url": null,      "fileName": null,      "mimeType": null,      "sizeBytes": null,      "pinned": true,      "status": "ready",      "failure": null,      "chunks": 1,      "chars": 71,      "origin": "api",      "createdBy": "usr_5f2a9c71",      "createdAt": "2026-10-08T09:12:44.000Z",      "updatedAt": "2026-10-08T09:12:44.000Z",      "indexedAt": "2026-10-08T09:12:45.000Z"    }],  "hasMore": false,  "nextCursor": null}

Une clé ou une application limitée à certaines adresses voit les éléments de tout l'espace de travail et ceux de ses adresses et de leurs domaines. Un niveau qu'elle ne peut pas voir ne liste rien.

Un curseur que cette liste n'a pas fourni est une 400 invalid_cursor.

Référence