Skip to main content

POST Criar Consulta

Cria uma nova consulta para um paciente.

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 create_preconsultations. Tanto com token JWT quanto com API Key, todas são obrigatórias.


Endpoint​

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

Corpo da Requisição​

CampoTipoObrigatórioDescrição
patientIdnumber✅ID do paciente
consultationTypestring (enum)✅"ONLINE" ou "PRESENCIAL"
preConsultationobject❌Dados da pré-consulta
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"
preConsultationIdnumber❌ID de uma pré-consulta existente — ela passa a CONVERTED e seus exames são transferidos para a consulta
triageIdnumber❌ID da triagem de origem, quando o médico decide a triagem como consulta. Mutuamente exclusivo com preConsultationId e preConsultation
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 (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
medicalCertificatestring❌Atestado médico
declarationstring❌Declaração de comparecimento
specialControlPrescriptionstring❌Receituário controle especial
iaConclusionstring❌Conclusão da IA
cardiologicalOpinionFileIdnumber❌ID do arquivo de parecer cardiológico
specialControlPrescriptionFileIdnumber❌ID do arquivo de receituário
appointmentIdnumber❌ID do agendamento vinculado
assignedUserIdnumber❌ID do usuário responsável

Requisição​

curl -X 'POST' \
'https://api-dev.imagemais.com.br/api/consultations' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}' \
-H 'Content-Type: application/json' \
-d '{
"patientId": 17529,
"consultationType": "ONLINE",
"preConsultation": {
"bloodPressure": "120/80",
"heartRate": "72",
"temperature": "36.5",
"weight": "70",
"height": "175",
"consultationReason": "Dor de cabeça frequente",
"glucose": "90"
},
"mainComplaint": "Dor de cabeça frequente há 3 dias",
"appointmentId": 5285,
"assignedUserId": 1
}'

Respostas​

201 Criado​

consultationTypeId e consultationStatusId não são fixos

Assim como em outros módulos, esses IDs são gerados via connectOrCreate na primeira vez que o valor é usado naquela conta — não são constantes entre ambientes.

{
"id": 37,
"patientId": 53,
"preConsultationId": 28,
"triageId": null,
"mainComplaint": "Dor de cabeça frequente há 3 dias",
"currentDiseaseHistory": null,
"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.053Z",
"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": null,
"temperature": null,
"weight": null,
"height": null,
"consultationReason": "Cefaleia",
"glucose": null,
"status": "OPEN",
"createdAt": "2026-09-29T22:33:38.996Z",
"updatedAt": "2026-09-29T22:33:38.996Z",
"deletedAt": null
},
"consultationFiles": [],
"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",
"email": null
}
},
"assignedUser": null
}

400 Bad Request​

Ocorre quando os campos obrigatórios têm valor inválido ou o tipo está errado.

Exemplos de causa:

  • patientId enviado como string ("abc")
  • consultationType com valor fora do enum ("HIBRIDO")
  • cardiologicalOpinionFileId: 0 (deve ser positivo)
{
"statusCode": 400,
"message": ["patientId must be a positive number"],
"error": "Bad Request"
}

Retornado quando triageId é enviado junto com preConsultationId ou preConsultation.

{
"message": "Informe apenas uma origem: triagem ou pré-consulta",
"error": "Bad Request",
"statusCode": 400
}

Retornado quando o patientId não existe na conta.

{
"statusCode": 400,
"message": "O paciente não Existe"
}

403 Sem Permissão​

Retornado quando o usuário autenticado não possui as permissões create_consultations e create_preconsultations.

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

404 Não Encontrado​

Retornado quando cardiologicalOpinionFileId ou specialControlPrescriptionFileId não correspondem a um arquivo da conta, ou quando assignedUserId não existe ("Usuário não encontrado").

{
"message": "Arquivo do parecer cardiológico não encontrado",
"error": "Not Found",
"statusCode": 404
}

409 Conflito​

Retornado quando o assignedUserId já tem outra consulta OPENED atribuída.

{
"message": "Usuário já possui 1 consulta(s) aberta(s) atribuída(s)",
"error": "Conflict",
"statusCode": 409
}