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
| Nome | Tipo | Obrigatório | Valores válidos | Descrição |
|---|---|---|---|---|
startDate | string | ✅ | data ISO 8601 | Data inicial do bloqueio |
endDate | string | ✅ | data ISO 8601 | Data final (a mesma de startDate bloqueia um único dia) |
startTime | string | ❌ | formato HH:mm | Horário de início (omita junto com endTime para bloquear o dia inteiro) |
endTime | string | ❌ | formato HH:mm | Horá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 inicialInforme startTime e endTime juntos, ou nenhum dos dois para bloquear o dia inteirostartTime 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
}