Saltar para a documentação
API

Listar itens de conhecimento

Os itens da base de conhecimento, dos mais recentes para os mais antigos, uma página de cada vez.

GET/knowledge

Executa a chamada real no seu espaço de trabalho.

GET /knowledge

Os itens da base de conhecimento, dos mais recentes para os mais antigos, uma página de cada vez.

Exemplo

Requer knowledge:read. Todos os filtros são opcionais: scope mantém um nível, level um tipo de nível (workspace, domain ou address), kind notas, ficheiros ou ligações, status um estado, pinned as notas afixadas, e q compara palavras do título, do nome do ficheiro ou da ligação. limit vai até 100 e é 50 por predefinição, e cursor recebe o nextCursor da página anterior.

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

Uma chave ou uma aplicação limitada a certos endereços vê os itens de todo o espaço de trabalho e os dos seus endereços e dos respetivos domínios. Um nível que não consegue ver não lista nada.

Um cursor que esta lista não entregou é um 400 invalid_cursor.

Referência