Skip to main content

DELETE Remover Bloqueio de Agenda da Clínica

Remove (exclusão lógica) todos os bloqueios ativos da conta com exatamente o período informado (datas e horários). É o inverso de Criar Bloqueio de Agenda da Clínica. Horário vazio na query (?startTime=&endTime=) equivale a dia inteiro.

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 config_schedules.


Endpoint​

DELETE https://api-dev.imagemais.com.br/api/schedule-blocks/batch

Parâmetros de Query​

NomeTipoObrigatórioValores válidosDescrição
startDatestring✅data ISO 8601Data inicial do bloqueio
endDatestring✅data ISO 8601Data final (a mesma de startDate bloqueia um único dia)
startTimestring❌formato HH:mmHorário de início (omita junto com endTime para bloquear o dia inteiro)
endTimestring❌formato HH:mmHorário de fim (omita junto com startTime para bloquear o dia inteiro)

Requisição​

curl -X 'DELETE' \
'https://api-dev.imagemais.com.br/api/schedule-blocks/batch?startDate=2026-12-24&endDate=2026-12-24' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}'

Respostas​

204 Sem conteúdo​

Resposta sem corpo.

400 Requisição inválida​

Mensagens de validação dos campos e:

  • A data final do bloqueio não pode ser anterior à data inicial
  • Informe startTime e endTime juntos, ou nenhum dos dois para bloquear o dia inteiro
  • startTime deve ser anterior a endTime
{
"message": "Informe startTime e endTime juntos, ou nenhum dos dois para bloquear o dia inteiro",
"error": "Bad Request",
"statusCode": 400
}

403 Sem permissão​

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

404 Não encontrado​

{
"message": "Nenhum bloqueio de agenda encontrado para este período",
"error": "Not Found",
"statusCode": 404
}

500 Erro interno​

{
"message": "Erro ao remover bloqueios de agenda da clínica",
"error": "Internal Server Error",
"statusCode": 500
}