VolundOS
Referência da APIConhecimento

Excluir documento

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

Atualizado em 04 de novembro de 2026
DELETE
/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 DELETE "https://example.com/v1/knowledge/bases/497f6eca-6276-4993-bfeb-53cbbbba6f08/documents/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "deleted": true,  "document_id": "b792e8ae-2cb4-4209-85b9-32be4c2fcdd6",  "name": "string"}

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.

Iniciar envio grande

Primeira etapa do envio de um arquivo de até 50MB. Devolve `upload_id` e `upload` (`url`, `method`, `headers`): faça a requisição com os bytes exatamente assim, direto no armazenamento, e confirme em `uploads/{uploadId}/complete`. Os bytes não passam pela API. O envio vence em 24 h. Exige o escopo knowledge:write.