Alertas da aplicação

Use estes endpoints para consultar e ativar os alertas por e-mail de uma aplicação. Os alertas ficam desligados por padrão, valem para projetos de aplicação (HTTP) e não se aplicam a ambientes de preview. Veja o comportamento completo em Observabilidade.

Permissões necessárias

Consultar exige acesso de leitura ao projeto (project.read em project:<project-id>). Alterar exige project.instances.update no mesmo projeto. owner tem acesso completo; assistant, member e API Keys precisam do scope específico.

Consultar alertas

GET /v1/project/:id/alerts

Exige project.read. Limite de requisições: 100 por minuto (contado por IP de origem).

{
  "status": "success",
  "data": {
    "enabled": false,
    "cpu_threshold_percent": 80,
    "memory_threshold_percent": 80,
    "cooldown_minutes": 60,
    "last_alerts": {
      "error": null,
      "cpu": "2026-10-07T12:00:00.000Z",
      "memory": null
    }
  }
}

Os limites de CPU e memória e o intervalo mínimo entre e-mails são fixos e retornados apenas para consulta. last_alerts informa quando cada tipo de alerta (error, cpu, memory) foi enviado na última hora; null quando nenhum foi enviado nesse período.

Ativar ou desativar alertas

PATCH /v1/project/:id/alerts

Exige project.instances.update. Limite de requisições: 20 a cada 5 minutos (contado por IP de origem).

{
  "enabled": true
}

enabled é obrigatório e precisa ser booleano; caso contrário a resposta é 400. Outros campos no body são ignorados.

Ambas as operações retornam 404 quando o projeto não existe e 400 quando o projeto não é HTTP ou é um ambiente de preview.