API
List knowledge items
The items in the knowledge base, newest first, a page at a time.
GET/knowledge
Runs the real call on your workspace.
GET /knowledge
The items in the knowledge base, newest first, a page at a time.
Example
Needs knowledge:read. Every filter is optional: scope keeps one level, level one kind of level (workspace, domain or address), kind notes, files or links, status one status, pinned the pinned notes, and q matches words in the title, the file name or the link. limit goes up to 100 and defaults to 50, and cursor takes the previous page’s nextCursor.
curl "$OE/knowledge?level=domain&limit=20" -H "$AUTH"{ "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}A key or an app limited to particular addresses sees the whole-workspace items and the items at its addresses and at their domains. A level it cannot see lists nothing.
A cursor this list did not hand out is a 400 invalid_cursor.