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
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | number | ✅ | ID da triagem |
Corpo da Requisição
| Campo | Tipo | Obrigatório | Valores válidos | Descrição |
|---|---|---|---|---|
outcomes | string[] | ✅ | PRESCRIPTION, EXAMS, REFERRAL, CONSULTATION, GUIDANCE; ao menos 1 item; até 4 itens | Um a quatro desfechos combináveis, ou [CONSULTATION] sozinha |
diagnosis | string | ❌ | não vazio; até 500 caracteres | Hipóteses diagnósticas escolhidas pelo médico, separadas por ponto, com o CID de cada uma |
diagnosisCid | string | ❌ | até 20 caracteres | CID da primeira hipótese — os demais vão em diagnosis |
diagnosisSelection | object[] | ❌ | até 10 itens | Hipóteses marcadas, na ordem, indicando quais vieram da sugestão da IA |
diagnosisSelection[].name | string | ❌ | não vazio; até 300 caracteres | Nome |
diagnosisSelection[].cid | string | ❌ | até 20 caracteres | Código CID |
diagnosisSelection[].fromAi | boolean | ❌ | — | true quando veio da sugestão do Assistente Diagnóstico; false quando foi digitada |
prescriptionNotes | string | ❌ | não vazio; 10–4000 caracteres | O que está sendo prescrito e como usar |
examNotes | string | ❌ | não vazio; 10–4000 caracteres | Exames solicitados, um por linha |
referralSpecialty | string | ❌ | não vazio; 3–120 caracteres | Especialidade do encaminhamento |
referralUrgency | string | ❌ | ELECTIVE, PRIORITY, URGENT | Urgência do encaminhamento |
referralReason | string | ❌ | não vazio; 10–4000 caracteres | Texto lido pelo especialista |
scheduling | string | ❌ | NOW, FIT_TODAY, SCHEDULE | Como a próxima etapa será agendada |
consultationType | string | ❌ | ONLINE, PRESENCIAL | Tipo de consulta |
consultationNote | string | ❌ | até 4000 caracteres | Vira medicalConduct da consulta criada |
guidanceTemplate | string | ❌ | até 120 caracteres | Texto de orientação entregue ao paciente |
guidanceText | string | ❌ | não vazio; 10–4000 caracteres | Texto entregue ao paciente |
sentByWhatsapp | boolean | ❌ | — | Se a orientação foi enviada pelo WhatsApp |
printed | boolean | ❌ | — | 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 insuficientesAçã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
}