DELETE Deletar Consulta

Remove uma consulta pelo seu ID.

Autenticação necessária

Esta rota requer o header Authorization: Bearer {accessToken}

Ação irreversível

A exclusão de uma consulta não pode ser desfeita (soft delete — o registro é preservado com deletedAt preenchido, mas não há rota para reverter).

O id da URL é ignorado

Apesar do endpoint aceitar {id} na URL, o handler não lê esse parâmetro — o id realmente usado vem do corpo da requisição. Enviar a requisição sem corpo retorna 400, mesmo com o ID correto na URL. Sempre inclua { "id": <consultaId> } no body.

---

Endpoint

DELETE https://api-dev.imagemais.com.br/api/consultations/{id}

---

Parâmetros

Path

Campo	Tipo	Obrigatório	Descrição
id	number	✅	Presente na URL, mas ignorado pelo servidor (ver aviso acima)

Corpo da Requisição

Campo	Tipo	Obrigatório	Descrição
id	number (inteiro positivo)	✅	ID da consulta a ser deletada — este é o valor efetivamente usado

---

Requisição

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

---

Respostas

200 Sucesso

{
  "message": "Consultation 1 deletado com sucesso",
  "status": 200
}

400 id ausente ou inválido no corpo

Retornado quando o corpo da requisição não é enviado ou o id é inválido — mesmo que a URL contenha um ID válido.

{
  "statusCode": 400,
  "message": [
    "id must be an integer number",
    "id must be a positive number",
    "id must be a number conforming to the specified constraints"
  ],
  "error": "Bad Request"
}

404 Consulta não encontrada

Retornado quando o id informado no corpo não corresponde a nenhuma consulta existente.

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

403 Sem Permissão

Retornado quando o usuário autenticado não possui permissão para deletar consultas.

{
  "statusCode": 403,
  "message": "Forbidden resource"
}