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.
Authorization
chaveDeApi Chave de API da organização, criada nas configurações. Envie-a em Authorization: Bearer <sua chave>.
In: header
Path Parameters
uuiduuidResponse 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", "kind": "markdown", "mime_type": "string", "size_bytes": 0, "version": 0, "download_url": "string", "download_expires_in": 0 }}Criar documento
Markdown em JSON (`name`, `content`), ou um arquivo em multipart no campo `file`, até 4MB. Com `mode=extract` (o padrão) o arquivo (PDF, DOCX, planilha, texto) é convertido em markdown pelo mesmo extrator da tela. Com `mode=file` ele é guardado como veio (imagem, PDF, planilha, zip...), no caminho `path`. Com `document_id`, os bytes substituem os daquele documento. Arquivos maiores: `uploads`. Exige poder editar a base. Exige o escopo knowledge:write.
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.