Remover cliente de um monitoramento

Remove do monitoramento informado em monitoringId o cliente informado em clientId.

O cliente continua cadastrado na empresa e nos outros monitoramentos. Os alertas dele neste monitoramento deixam de contar. Se era o último cliente, o monitoramento passa a DRAFT; um ENDED com o período vencido continua ENDED. O histórico registra a remoção e, quando ocorre, a passagem para DRAFT (MONITORING_DRAFTED). Para trocar vários clientes de uma vez, use a rota de definir clientes de um monitoramento. A resposta é 204 sem corpo.

Só quem criou o monitoramento pode remover clientes, e um monitoramento INACTIVE precisa ser reativado antes. 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 excluir 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).

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

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

Respostas

🟢204Sucesso

application/json

Cliente removido do monitoramento (sem corpo)

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠429TooManyRequests

🔴500InternalError

🟠400Sem permissão para excluir monitoramentos

🟠403Acesso negado

🟠404Monitoramento ou cliente não encontrado

🟠422Monitoramento desativado

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

Remover cliente de um monitoramento

Requisição

Respostas