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
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | number | ✅ | ID da triagem |
Corpo da Requisição
| Campo | Tipo | Obrigatório | Valores válidos | Descrição |
|---|---|---|---|---|
position | number | ✅ | inteiro; mín. 1 | Posição do turno que está sendo respondido. Só o turno atual é aceito. |
answer | string | ✅ | até 4000 caracteres | O 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
}