Referência da API

Eventos

Um evento é uma mudança voltada ao usuário — um delta que passou pelo filtro de importância. Os eventos são o que você consome para reagir a mudanças.

Cada evento carrega uma severity de info, low, medium, high ou critical, além de um title e um summary legíveis por humanos. Faça polling deste endpoint, ou registre um canal de webhook para receber os eventos assim que acontecerem.

GET/v1/events

Listar eventos

Retorna os eventos de mudança desta assinatura, do mais novo para o mais antigo. Eventos dispensados são excluídos.

Parâmetro	Tipo	Descrição
`projectId`opcionalquery	uuid	Restringe a um projeto específico. Omita para todos os projetos.
`limit`opcionalquery	integer (1–200)	Número máximo de eventos a retornar. O padrão é 60.

Requisição

curl "https://gabinete360.ia.br/api/v1/events?limit=20" \
  -H "Authorization: Bearer argos_ak_live_••••••"

Resposta

200 OK

[
  {
    "id": "c0ffee…",
    "projectId": "8f3c1a2b-…",
    "title": "Price changed on Acme pricing page",
    "summary": "Pro plan went from $49 to $59 / month.",
    "severity": "high",
    "eventType": "price_change",
    "sourceDomain": "example.com",
    "sourceUrl": "https://example.com/pricing",
    "createdAt": "2026-05-24T19:05:42.000Z"
  }
]

Dicas de polling

Os eventos são retornados do mais novo para o mais antigo. Acompanhe o createdAt mais recente que você já viu e trate qualquer coisa mais nova como não processada.
Faça polling em uma cadência que combine com os intervalos de pulse dos seus alvos — fazer polling mais rápido do que os alvos são verificados só retorna os mesmos dados.
Para entrega em tempo real sem polling, use um canal de webhook em vez disso.