Skip to main content

POST Responder Turno

Fecha o turno atual e devolve a próxima pergunta. Grava a resposta escrita pelo profissional e decide o passo seguinte: nova pergunta gerada a partir dela, ou encerramento quando o assistente declara ter o suficiente.

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 a permissão update_triages.


Endpoint​

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

Parâmetros de Rota​

NomeTipoObrigatórioDescrição
idnumber✅ID da triagem

Corpo da Requisição​

CampoTipoObrigatórioValores válidosDescrição
positionnumber✅inteiro; mín. 1Posição do turno que está sendo respondido. Só o turno atual é aceito.
answerstring✅até 4000 caracteresO que o paciente respondeu, escrito pelo profissional que conduz a entrevista. Não é transcrição automática: é o relato em palavras simples.

Requisição​

curl -X 'POST' \
'https://api-dev.imagemais.com.br/api/triages/1/interview/turn' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}' \
-H 'Content-Type: application/json' \
-d '{
"position": 4,
"answer": "Começou anteontem à noite e hoje piorou"
}'

Respostas​

201 Sucesso​

{
"nextAction": "next_turn",
"turn": {
"id": 136,
"interviewId": 14,
"position": 2,
"question": "Texto de exemplo.",
"source": "AI",
"answer": null,
"answeredAt": null,
"createdAt": "2026-09-30T18:52:57.809Z"
}
}

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": [
"position must not be less than 1",
"position must be an integer number",
"answer must be shorter than or equal to 4000 characters",
"answer must be longer than or equal to 1 characters",
"answer must be a string"
],
"error": "Bad Request",
"statusCode": 400
}

Outras mensagens possíveis:

  • Validation failed (numeric string is expected)
  • Só o turno atual da entrevista pode ser respondido
{
"message": "Validation failed (numeric string is expected)",
"error": "Bad Request",
"statusCode": 400
}

403 Sem permissão​

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

404 Não encontrado​

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

409 Conflito​

{
"message": "Esta entrevista já foi encerrada",
"error": "Conflict",
"statusCode": 409
}