Desativar monitoramento

POST

/v2/monitoring/{monitoringId}/deactivate

Desativa o monitoramento informado em monitoringId: ele passa a INACTIVE, com deactivationReason MANUAL, e nenhum módulo é consultado de novo enquanto ele estiver desativado.

Os alertas e o histórico continuam disponíveis para consulta. A desativação entra no histórico do monitoramento. Enquanto estiver desativado, o monitoramento não pode ser editado nem ter clientes alterados; para voltar a rodar, use a rota de reativar monitoramento. Não recebe corpo.

Vale para monitoramentos em qualquer status, exceto os que já estão INACTIVE. Só quem criou o monitoramento pode desativá-lo. Monitoramento inexistente ou de outra empresa devolve 404 (Monitoria não encontrada.). 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

🟢200Sucesso

application/json

Monitoramento desativado

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠429TooManyRequests

🔴500InternalError

🟠400Sem permissão para editar monitoramentos

🟠403Acesso negado

🟠404Monitoramento não encontrado

🟠422Monitoramento já desativado

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/v2/monitoring/9c1e4b7a-0000-4000-8000-000000000d01/deactivate' \
--header 'x-api-key: SUA_CHAVE_DE_API' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Sucesso

{
    "status": "INACTIVE"
}

Modificado em 2026-10-21 13:17:45

Página anterior

Visualizar monitoramento

Próxima página

Listar histórico de alterações de um monitoramento