Limpar alertas de um cliente

POST

/v2/monitoring/{monitoringId}/clients/{clientId}/alerts/clear

Limpa os alertas de risco do cliente informado em clientId, no monitoramento informado em monitoringId.

Vale para os alertas de todos os módulos ligados, lidos ou não, inclusive os de rodadas anteriores. Os alertas limpos deixam de aparecer na listagem de alertas do cliente e de contar nos contadores do monitoramento. Não há rota para desfazer a limpeza. As próximas consultas continuam gerando alertas novos. Não recebe corpo, e a resposta é 204 sem corpo; chamar de novo, sem alertas a limpar, também devolve 204.

Só quem criou o monitoramento pode limpar os alertas, e funciona também com o monitoramento INACTIVE. Monitoramento inexistente ou de outra empresa devolve 404 (Monitoria não encontrada.). Cliente que não está no monitoramento devolve 404 (Cliente não monitorado nesta monitoria.). Requer autenticação via Bearer JWT ou header x-api-key e a permissão de editar monitoramentos. Usuário sem perfil de permissão recebe 403 (Acesso negado); perfil inexistente, 401 (Permissão inválida!); perfil sem a permissão, 400 (Permissão não encontrada); usuário inativo, 404 (Usuário não encontrado).

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros de Caminho

Parâmetros Header

Respostas

🟢204Sucesso

application/json

Alertas limpos (sem corpo)

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠429TooManyRequests

🔴500InternalError

🟠400Sem permissão para editar monitoramentos

🟠403Acesso negado

🟠404Monitoramento ou cliente não encontrado

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/v2/monitoring/9c1e4b7a-0000-4000-8000-000000000d01/clients/7c9e6679-7425-40de-944b-e07fc1f90ae7/alerts/clear' \
--header 'x-api-key: SUA_CHAVE_DE_API' \
--header 'Authorization: Bearer <token>'

Response Example

204 - Exemplo 1

{}

Modificado em 2026-10-21 13:15:15

Página anterior

Verificar aceite dos termos de uso

Próxima página

Marcar falhas de consulta do monitoramento como vistas