Marcar falhas de consulta do monitoramento como vistas

POST

/v2/monitoring/{monitoringId}/queries/seen

Marca como vistas as falhas de consulta do monitoramento informado em monitoringId.

A partir da marcação, o campo hasQueryError do detalhe do monitoramento volta a false. Ele só fica true de novo quando uma falha nova for registrada depois da marcação: consulta sem resultado, que falhou ou com módulo pulado por indisponibilidade. Isso vale também para consultas disparadas antes da marcação cuja falha só foi registrada depois. Só conta módulos com alertEnabled; a falha de um módulo com alerta desligado não aparece aqui. Não altera os alertas: as falhas continuam no histórico de consultas do monitoramento, com alertStatus QUERY_ERROR. Não recebe corpo, e a resposta é 204 sem corpo; chamar de novo também devolve 204.

Só quem criou o monitoramento pode marcar, e funciona também com o monitoramento INACTIVE. 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

🟢204Sucesso

application/json

Falhas marcadas como vistas (sem corpo)

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠429TooManyRequests

🔴500InternalError

🟠400Sem permissão para editar monitoramentos

🟠403Acesso negado

🟠404Monitoramento não encontrado

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

204 - Sem permissão para editar monitoramentos

{
    "message": [
        "Permissão não encontrada"
    ],
    "statusCode": 400
}

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

Página anterior

Limpar alertas de um cliente

Próxima página

Listar monitoramentos da empresa