DELETE Encerrar Sala

Encerra a sala de telemedicina no LiveKit e finaliza a consulta.

Autenticação necessária

Esta rota requer o header Authorization: Bearer {accessToken}

Sem permissão específica

Não exige @CheckPermissions — qualquer usuário autenticado pode chamar.

Efeito colateral: finaliza a consulta

Além de encerrar a sala, esta rota muda o consultationStatus da consulta para FINAL — ou seja, fecha a consulta médica, não só a videochamada. Não é possível reabrir por esta rota.

---

Endpoint

DELETE https://api-dev.imagemais.com.br/api/telemedicine/delete

---

Corpo da Requisição

Campo	Tipo	Obrigatório	Descrição
consultationId	number (inteiro positivo)	✅	ID da consulta

---

O que acontece

1. Busca a consulta (OPENED + ONLINE + mesma conta) e o paciente vinculado — 404 se não encontrar.
2. Marca a consulta como FINAL.
3. Emite patient.room.closed (WebSocket telemedicine.room.closed para o paciente, mesma ressalva de entrega "melhor esforço" da rota de notificar).
4. Para qualquer gravação (egress) ainda ativa na sala.
5. Deleta a sala no LiveKit e limpa a preferência de transcrição em cache no Redis.

---

Requisição

curl -X 'DELETE' \
  'https://api-dev.imagemais.com.br/api/telemedicine/delete' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {accessToken}' \
  -d '{
  "consultationId": 123
}'

---

Respostas

200 Sucesso

Resposta vazia (sem corpo).

400 Validação

{
  "statusCode": 400,
  "message": ["ID da consulta deve ser um número", "ID da consulta deve ser um número positivo"],
  "error": "Bad Request"
}

404 Consulta não encontrada

{
  "statusCode": 404,
  "message": "Consulta não encontrada"
}

500 Erro interno

Mensagem de erro herdada de outra rota

Se qualquer passo do fluxo falhar de forma inesperada (LiveKit, egress, Redis), a mensagem retornada é "Erro ao notificar paciente para entrar na sala de telemedicina" — texto copiado da rota de notificar, não descreve o que de fato aconteceu (encerramento da sala).

{
  "statusCode": 500,
  "message": "Erro ao notificar paciente para entrar na sala de telemedicina"
}