Skip to main content

PATCH Atualizar Consulta

Atualiza os dados de uma consulta existente. Apenas os campos enviados serão modificados.

Autenticação necessária

Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.

Permissão necessária

Exige as permissões create_consultations e update_consultations. Tanto com token JWT quanto com API Key, todas são obrigatórias.

Finalizando uma consulta

Enviar closeConsultation: true muda o status para CLOSED, grava finalizedAt (data/hora atual) e finalizedByUserId (usuário autenticado), e emite o evento interno consultations.closed.


Endpoint​

PATCH https://api-dev.imagemais.com.br/api/consultations

Corpo da Requisição​

CampoTipoObrigatórioDescrição
idnumber (inteiro positivo)✅ID da consulta a ser atualizada
closeConsultationboolean❌true finaliza a consulta: muda status para CLOSED, grava finalizedAt e finalizedByUserId (usuário autenticado) e emite o evento consultations.closed
preConsultationIdnumber❌Aceito pela validação, mas a origem da consulta não é editável — valor ignorado
triageIdnumber❌Aceito pela validação, mas a origem da consulta não é editável — valor ignorado
mainComplaintstring❌Queixa principal
currentDiseaseHistorystring❌História da doença atual
personalHistorystring❌Antecedentes pessoais
physicalExamstring❌Exame físico
medicalConductstring❌Conduta médica
cardiovascularDiseasesstring❌Doenças cardiovasculares
otherRelevantDiseasesstring❌Outras doenças relevantes
previousSurgeriesstring❌Cirurgias anteriores
familyHistorystring❌Antecedentes familiares
medicationsUsestring❌Medicamentos em uso
allergiesstring❌Alergias
lifestyleHabitsstring❌Hábitos de vida
primaryAndSecondaryDiagnosisstring❌Diagnósticos primário e secundário (CID)
diagnosisReasoningstring❌Raciocínio da IA (achados confirmatórios e dados conflitantes)
urgencyLevelstring❌Nível de urgência — Protocolo de Manchester
prescribedMedicationsstring❌Medicamentos prescritos
lifestyleAdvicestring❌Orientações de estilo de vida
followUpExamsstring❌Exames de acompanhamento
referralsToSpecialistsstring❌Encaminhamentos para especialistas
medicalCertificatestring❌Atestado médico
declarationstring❌Declaração de comparecimento
specialControlPrescriptionstring❌Receituário de controle especial
iaConclusionstring❌Conclusão da IA
cardiologicalOpinionFileIdnumber❌ID do arquivo de parecer cardiológico
specialControlPrescriptionFileIdnumber❌ID do arquivo de receituário de controle especial
appointmentIdnumber❌ID do agendamento vinculado
assignedUserIdnumber❌ID do usuário responsável
consultationTypestring (enum)❌"ONLINE" ou "PRESENCIAL". Não pode ser alterado se a consulta já estiver CLOSED (retorna 400)
preConsultationobject❌Dados da pré-consulta a atualizar
preConsultation.bloodPressurestring❌Pressão arterial
preConsultation.heartRatestring❌Frequência cardíaca
preConsultation.temperaturestring❌Temperatura
preConsultation.weightstring❌Peso
preConsultation.heightstring❌Altura
preConsultation.consultationReasonstring❌Motivo da consulta
preConsultation.glucosestring❌Glicose
preConsultation.consultationTypestring (enum)❌"ONLINE" ou "PRESENCIAL"
diagnosisHypotheses`objectnull`❌
appliedProtocolIdsnumber[]❌Protocolos médicos aplicados; a lista enviada substitui a anterior (até 20 itens; inteiros)
prescriptionItems`object[]null`❌
requestedExamsobject[]❌Exames pedidos; a lista enviada substitui a anterior. Texto enviado sem a lista não mexe nos exames (até 100 itens)

Requisição​

curl -X 'PATCH' \
'https://api-dev.imagemais.com.br/api/consultations' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}' \
-H 'Content-Type: application/json' \
-d '{
"id": 1,
"mainComplaint": "Dor de cabeça há 3 dias",
"currentDiseaseHistory": "Paciente relata cefaleia intensa desde segunda-feira",
"physicalExam": "PA 120/80, FC 72bpm, bom estado geral",
"primaryAndSecondaryDiagnosis": "G43.9 - Enxaqueca não especificada",
"medicalConduct": "Repouso e hidratação oral",
"preConsultation": {
"bloodPressure": "120/80",
"heartRate": "72",
"temperature": "36.5",
"weight": "70",
"height": "175",
"consultationReason": "Cefaleia"
}
}'

Respostas​

200 Sucesso​

Retorna o objeto completo da consulta atualizada.

{
"id": 37,
"patientId": 53,
"preConsultationId": 28,
"triageId": null,
"mainComplaint": "Dor de cabeça frequente há 3 dias",
"currentDiseaseHistory": "Paciente relata cefaleia intensa desde segunda-feira",
"personalHistory": null,
"cardiovascularDiseases": null,
"otherRelevantDiseases": null,
"previousSurgeries": null,
"familyHistory": null,
"medicationsUse": null,
"allergies": null,
"lifestyleHabits": null,
"primaryAndSecondaryDiagnosis": null,
"diagnosisReasoning": null,
"prescribedMedications": null,
"lifestyleAdvice": null,
"followUpExams": null,
"referralsToSpecialists": null,
"iaConclusion": null,
"urgencyLevel": null,
"createdAt": "2026-09-29T22:33:39.053Z",
"updatedAt": "2026-09-29T22:33:39.315Z",
"deletedAt": null,
"physicalExam": null,
"declaration": null,
"medicalCertificate": null,
"consultationTypeId": 2,
"medicalConduct": null,
"specialControlPrescription": null,
"consultationStatusId": 1,
"assignedUserId": null,
"finalizedByUserId": null,
"finalizedAt": null,
"telemedicineTranscription": null,
"openaiThreadId": null,
"openaiConversationId": null,
"preConsultation": {
"id": 28,
"accountId": 1,
"patientId": 53,
"bloodPressure": "120/80",
"heartRate": "72",
"temperature": null,
"weight": null,
"height": null,
"consultationReason": "Cefaleia",
"glucose": null,
"status": "CONVERTED",
"createdAt": "2026-09-29T22:33:38.996Z",
"updatedAt": "2026-09-29T22:33:39.310Z",
"deletedAt": null
},
"consultationFiles": [],
"consultationStatus": {
"name": "OPENED"
},
"consultationType": {
"name": "PRESENCIAL"
},
"cardiologicalOpinion": null,
"specialControlPrescriptionPdf": null,
"patient": {
"id": 53,
"name": "Maria Oliveira Santos",
"cpf": "12345678900",
"dateBirth": "1948-08-04T00:00:00.000Z",
"gender": {
"name": "M"
},
"contact": {
"phone": "(81) 99999-9999"
}
}
}

400 Consulta já finalizada​

Retornado quando consultationType é informado, mas a consulta já está com status CLOSED.

{
"statusCode": 400,
"message": "Não é possível alterar o tipo de uma consulta já finalizada"
}

404 Consulta não encontrada​

Retornado quando o id informado não corresponde a nenhuma consulta existente.

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

403 Sem Permissão​

Retornado quando o usuário autenticado não possui permissão para atualizar consultas.

{
"message": "Permissões insuficientes",
"error": "Forbidden",
"statusCode": 403
}