Skip to main content

POST Registrar Desfecho

Registra o desfecho da triagem. Um a três desfechos combináveis (Prescrição, Encaminhamento, Orientação), ou Consulta sozinha.

Só com token de usuário

Envie o header Authorization: Bearer {accessToken} de um usuário. Esta rota não funciona com x-api-key: com x-api-key a resposta é 403 "Ação disponível apenas para usuários autenticados".

Permissão necessária

Exige a permissão decide_triages.


Endpoint​

POST https://api-dev.imagemais.com.br/api/triages/{id}/decision

Parâmetros de Rota​

NomeTipoObrigatórioDescrição
idnumber✅ID da triagem

Corpo da Requisição​

CampoTipoObrigatórioValores válidosDescrição
outcomesstring[]✅PRESCRIPTION, EXAMS, REFERRAL, CONSULTATION, GUIDANCE; ao menos 1 item; até 4 itensUm a quatro desfechos combináveis, ou [CONSULTATION] sozinha
diagnosisstring❌não vazio; até 500 caracteresHipóteses diagnósticas escolhidas pelo médico, separadas por ponto, com o CID de cada uma
diagnosisCidstring❌até 20 caracteresCID da primeira hipótese — os demais vão em diagnosis
diagnosisSelectionobject[]❌até 10 itensHipóteses marcadas, na ordem, indicando quais vieram da sugestão da IA
diagnosisSelection[].namestring❌não vazio; até 300 caracteresNome
diagnosisSelection[].cidstring❌até 20 caracteresCódigo CID
diagnosisSelection[].fromAiboolean❌—true quando veio da sugestão do Assistente Diagnóstico; false quando foi digitada
prescriptionNotesstring❌não vazio; 10–4000 caracteresO que está sendo prescrito e como usar
examNotesstring❌não vazio; 10–4000 caracteresExames solicitados, um por linha
referralSpecialtystring❌não vazio; 3–120 caracteresEspecialidade do encaminhamento
referralUrgencystring❌ELECTIVE, PRIORITY, URGENTUrgência do encaminhamento
referralReasonstring❌não vazio; 10–4000 caracteresTexto lido pelo especialista
schedulingstring❌NOW, FIT_TODAY, SCHEDULEComo a próxima etapa será agendada
consultationTypestring❌ONLINE, PRESENCIALTipo de consulta
consultationNotestring❌até 4000 caracteresVira medicalConduct da consulta criada
guidanceTemplatestring❌até 120 caracteresTexto de orientação entregue ao paciente
guidanceTextstring❌não vazio; 10–4000 caracteresTexto entregue ao paciente
sentByWhatsappboolean❌—Se a orientação foi enviada pelo WhatsApp
printedboolean❌—Se a orientação foi impressa

Requisição​

curl -X 'POST' \
'https://api-dev.imagemais.com.br/api/triages/1/decision' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}' \
-H 'Content-Type: application/json' \
-d '{
"outcomes": [
"PRESCRIPTION"
],
"diagnosis": "Faringite aguda (CID-10: J02.9). Infecção de vias aéreas superiores (CID-10: J06.9)",
"diagnosisCid": "J02.9",
"diagnosisSelection": [
{
"name": "Faringite aguda",
"fromAi": true
}
],
"prescriptionNotes": "texto",
"examNotes": "Hemograma completo",
"referralSpecialty": "Cardiologia",
"referralUrgency": "ELECTIVE"
}'

Respostas​

201 Sucesso​

{
"id": 20,
"accountId": 1,
"patientId": 62,
"createdByUserId": 1,
"bloodPressure": "120/80",
"heartRate": "72",
"temperature": "36.5",
"weight": "70",
"height": "170",
"glucose": null,
"consultationReason": "Dor de cabeça há dois dias (teste da documentação)",
"priority": "NOT_URGENT",
"status": "RESOLVED",
"submittedAt": "2026-09-30T18:53:00.673Z",
"outcomes": [
"GUIDANCE"
],
"decidedByUserId": 1,
"decidedAt": "2026-09-30T18:53:01.143Z",
"diagnosis": "Cefaleia tensional (CID-10: G44.2)",
"diagnosisCid": "G44.2",
"diagnosisSelection": [
{
"cid": "G44.2",
"name": "Cefaleia tensional",
"fromAi": false
}
],
"memedPrescriptionId": null,
"prescriptionNotes": null,
"examNotes": null,
"referralSpecialty": null,
"referralUrgency": null,
"referralReason": null,
"scheduling": null,
"appointmentId": null,
"consultationType": null,
"consultationNote": null,
"guidanceTemplate": null,
"guidanceText": "Hidratação, repouso e retorno se piorar.",
"sentByWhatsapp": false,
"printed": true,
"createdAt": "2026-09-30T18:52:40.849Z",
"updatedAt": "2026-09-30T18:53:01.149Z",
"deletedAt": null,
"patient": {
"id": 62,
"name": "Nome Exemplo",
"cpf": null,
"dateBirth": null,
"gender": null,
"contact": null
},
"createdBy": {
"id": 1,
"name": "Nome Exemplo"
},
"decidedBy": {
"id": 1,
"name": "Nome Exemplo"
},
"assistantSession": {
"id": 21,
"userId": 1,
"accountId": 1,
"consultationId": null,
"preConsultationId": null,
"triageId": 20,
"state": "ASKING_QUESTION",
"livekitRoomName": null,
"clinicalSummary": null,
"createdAt": "2026-09-30T18:52:51.327Z",
"updatedAt": "2026-09-30T18:52:51.512Z",
"agentType": null,
"vitals": {
"height": "170",
"weight": "70",
"heartRate": "72",
"patientId": 62,
"temperature": "36.5",
"bloodPressure": "120/80",
"consultationReason": "Dor de cabeça há dois dias (teste da documentação)"
},
"patientId": 62,
"questions": [
{
"id": 101,
"sessionId": 21,
"order": 1,
"question": "Você tem sentido dor no peito ou falta de ar?",
"goal": "Identificar sinais de gravidade relacionados a problemas cardíacos ou respiratórios.",
"answer": null,
"createdAt": "2026-09-30T18:52:51.327Z",
"followUps": []
}
]
},
"interview": {
"id": 14,
"status": "ABANDONED",
"recordingState": "DISABLED",
"finishedAt": "2026-09-30T18:52:58.170Z",
"clinicalSummary": {
"aiNote": "O médico deve investigar a presença de outros sintomas associados à cefaleia, como náuseas ou alterações visuais.",
"summary": "Texto de exemplo.",
"warningSigns": [],
"collectedFindings": {
"Comorbidades": "Nenhuma relatada",
"Irradiação": "Não relatada",
"Queixa principal": "Cefaleia intensa",
"Tempo de evolução": "Dois dias"
},
"suggestedPriority": "LOW_URGENCY"
}
},
"consultation": null,
"decisionRevisions": [],
"triageFiles": [
{
"id": 168,
"url": "https://storage.exemplo.com.br/triagem/audio.webm",
"fileType": "triage-audio",
"name": "Áudio da triagem da data: 30/09/2026 15:52:41",
"createdAt": "2026-09-30T18:52:41.440Z",
"updatedAt": "2026-09-30T18:52:41.444Z",
"deletedAt": null,
"accountId": null,
"examOcrResult": null
}
],
"decisionDocuments": []
}

400 Requisição inválida​

Retornado quando o corpo ou a query não passam na validação. A lista message traz um item por regra violada, por exemplo:

{
"message": [
"Informe ao menos um desfecho, sem repetir; Consulta não combina com os demais",
"each value in outcomes must be one of the following values: PRESCRIPTION, EXAMS, REFERRAL, CONSULTATION, GUIDANCE",
"outcomes must contain no more than 4 elements",
"outcomes should not be empty",
"outcomes must be an array"
],
"error": "Bad Request",
"statusCode": 400
}

Também retornado com a mensagem:

{
"message": "Validation failed (numeric string is expected)",
"error": "Bad Request",
"statusCode": 400
}

403 Sem permissão​

Mensagens possíveis:

  • Permissões insuficientes
  • Ação disponível apenas para usuários autenticados
{
"message": "Permissões insuficientes",
"error": "Forbidden",
"statusCode": 403
}

404 Não encontrado​

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

409 Conflito​

{
"message": "Triagem no status {status} não pode {action}",
"error": "Conflict",
"statusCode": 409
}