Ir a la documentación
API

Listar elementos de conocimiento

Los elementos de la base de conocimiento, del más reciente al más antiguo, de página en página.

GET/knowledge

Ejecuta la llamada real en tu espacio de trabajo.

GET /knowledge

Los elementos de la base de conocimiento, del más reciente al más antiguo, de página en página.

Ejemplo

Requiere knowledge:read. Todos los filtros son opcionales: scope deja un nivel, level un tipo de nivel (workspace, domain o address), kind notas, archivos o enlaces, status un estado, pinned las notas fijadas, y q compara palabras del título, del nombre de archivo o del enlace. limit llega hasta 100 y vale 50 por defecto, y cursor toma el nextCursor de la página anterior.

curl
curl "$OE/knowledge?level=domain&limit=20" -H "$AUTH"
Respuesta
{  "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}

Una clave o una aplicación limitada a ciertas direcciones ve los elementos de todo el espacio de trabajo y los de sus direcciones y sus dominios. Un nivel que no puede ver no lista nada.

Un cursor que esta lista no entregó es un 400 invalid_cursor.

Referencia