VolundOS
Referência da APIConhecimento

Ler documento

O documento com o markdown completo. Exige o escopo knowledge:read.

Atualizado em 25 de setembro de 2026
GET
/v1/knowledge/bases/{baseId}/documents/{documentId}

Authorization

chaveDeApi
AuthorizationBearer <token>

Chave de API da organização, criada nas configurações. Envie-a em Authorization: Bearer <sua chave>.

In: header

Path Parameters

baseId*string
Formatuuid
documentId*string
Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/knowledge/bases/497f6eca-6276-4993-bfeb-53cbbbba6f08/documents/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "document": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "name": "string",    "summary": "string",    "status": "string",    "path": "string",    "content": "string"  }}

Criar documento

Markdown em JSON (`name`, `content`), ou um arquivo em multipart no campo `file` (PDF, DOCX, planilha, texto), convertido em markdown pelo mesmo extrator da tela, até 4MB. Exige poder editar a base. Exige o escopo knowledge:write.

Atualizar documento

Substitui o conteúdo. Com `expected_version`, a escrita é recusada (409) se o documento mudou desde a leitura, em vez de sobrescrever. Exige o escopo knowledge:write.