VolundOS
Referência da APIConhecimento

Confirmar envio grande

Segunda etapa: grava o que foi enviado como documento, no `path` (ou no `document_id`) informado de novo aqui. `.md` vira texto da base; o resto é guardado como veio. Exige o escopo knowledge:write.

Atualizado em 04 de novembro de 2026
POST
/v1/knowledge/bases/{baseId}/documents/uploads/{uploadId}/complete

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
uploadId*string

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

application/json

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

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.

Mover documentos entre bases

Copia para a base de destino, no mesmo caminho (markdown como texto, arquivo byte a byte), e remove da origem, até 50 por chamada. Com `target_path`, UM documento ganha nova pasta ou nome; sem `target_base_id`, isso acontece dentro da mesma base. Exige poder editar as duas. Se a remoção da origem for recusada, a cópia é desfeita. O resultado lista, item a item, o que moveu e o que falhou. Exige o escopo knowledge:write.