VolundOS
Referência da APIConhecimento

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.

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

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

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" \  -H "Content-Type: application/json" \  -d '{    "size": 0  }'
{  "upload_id": "string",  "path": "string",  "document_id": "b792e8ae-2cb4-4209-85b9-32be4c2fcdd6",  "max_bytes": 0,  "expires_in": 0,  "upload": {    "url": "string",    "method": "PUT",    "headers": {      "property1": "string",      "property2": "string"    }  }}