Skip to main content

POST Upload de Documento de Conduta

Realiza o upload de um documento vinculado à conduta médica de uma consulta (prescrições, exames, encaminhamentos, orientações, atestado, declaração, parecer cardiológico, receita controlada).

Autenticação necessária

Esta rota requer o header Authorization: Bearer {accessToken}

Formato da requisição

Esta rota utiliza multipart/form-data. Apesar do nome sugerir apenas PDF, são aceitos pdf, doc, docx, xls, xlsx e txt.


Endpoint

POST https://api-dev.imagemais.com.br/api/consultations/conduct-document/upload

Corpo da Requisição (multipart/form-data)

CampoTipoObrigatórioDescrição
fileFile (pdf, doc, docx, xls, xlsx, txt)Arquivo a ser enviado
consultationIdnumberID da consulta vinculada
documentTypestring (enum)Tipo do documento (ver valores aceitos abaixo)

Valores aceitos para documentType

ValorDescrição
parecer-cardiologicoParecer cardiológico
receita-controladaReceita de controle especial
prescricoesPrescrições médicas
exames-laboratoriaisExames laboratoriais
exame-imagemExames de imagem
encaminhamentosEncaminhamentos para especialistas
orientacoesOrientações ao paciente
atestadoAtestado médico
declaracaoDeclaração de comparecimento

Requisição

curl -X 'POST' \
'https://api-dev.imagemais.com.br/api/consultations/conduct-document/upload' \
-H 'Authorization: Bearer {accessToken}' \
-F 'file=@"/caminho/para/documento.pdf"' \
-F 'consultationId=1' \
-F 'documentType=prescricoes'

Respostas

201 Criado

Retorna o objeto do arquivo salvo com a URL de acesso.

{
"id": 317,
"url": "https://storagedev.imagemaislaboratorio.com.br/consultations/1/prescricoes/c08c441ef33a7d37e5fd698375855458414891025da22e47b864347e0f770f7f",
"fileType": "pdf",
"name": "Prescrições - ImageMais.pdf",
"accountId": null,
"createdAt": "2026-05-19T11:13:35.765Z",
"updatedAt": "2026-05-19T11:13:35.765Z",
"deletedAt": null
}

400 Tipo de arquivo não permitido

Retornado quando a extensão do arquivo enviado não está entre pdf, doc, docx, xls, xlsx, txt.

{
"statusCode": 400,
"message": "Tipo de arquivo não permitido"
}

404 Consulta não encontrada

Retornado quando o consultationId informado não existe (ou pertence a outra conta).

{
"statusCode": 404,
"message": "Consulta não encontrada",
"error": "Not Found"
}

403 Sem Permissão

Retornado quando o usuário autenticado não possui permissão para fazer upload de documentos de conduta.

{
"statusCode": 403,
"message": "Forbidden resource"
}