VolundOS
Referência da APIConhecimento

Atualizar documento

Com `content`: substitui o texto de um documento markdown (um arquivo recusa com 409). Com `path`: muda o documento de pasta ou de nome, markdown ou arquivo, mantendo o tipo. Os dois não vão juntos. Com `expected_version`, a escrita é recusada (409) se o documento mudou desde a leitura, em vez de sobrescrever. Exige o escopo knowledge:write.

Atualizado em 04 de novembro de 2026
PATCH
/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

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/v1/knowledge/bases/497f6eca-6276-4993-bfeb-53cbbbba6f08/documents/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{}'
{  "document_id": "b792e8ae-2cb4-4209-85b9-32be4c2fcdd6",  "summary": "string",  "version": 0,  "name": "string",  "path": "string",  "previous_path": "string"}

Ler documento

Markdown: o documento com o conteúdo completo em `content`. Arquivo (`kind: file`): sem `content`, com `download_url`, um link assinado para baixar os bytes, válido por `download_expires_in` segundos. Exige o escopo knowledge:read.

Excluir documento

Apaga o documento da base. Exige o escopo knowledge:write.