Alerts

One alert with its delivery record

Returns one fired alert (message, facts, evidence link) with its delivery record: status (pending, delivered or failed), attempts so far out of the maximum, the last and next attempt times, when it was delivered and the last failure as shown in the app. The app stores the latest attempt, not a separate row per attempt. A finding covered by a digest is delivered only inside that digest and shares its outcome.

get/alert-events/{event_id}

Request

  • Base URL: https://adslighthouse.com/api/v1
  • URL: https://adslighthouse.com/api/v1/alert-events/{event_id}
  • Auth: HTTP bearer

Path parameters

event_idstring required

The alert event id from list_alert_events or send_test_alert.

Response

One alert with its delivery record

idstring required
project_idstring nullable required
brand_namestring required
type'competitor_new' | 'competitor_returning' | 'hijack_detected' | 'affiliate_detected' | 'ranking_drop' | 'nklg_re_enable' | 'ingestion_failed' | 'summary_digest' required
titlestring required
textstring required
fired_atstring required
channel'email' | 'webhook' | 'slack' required
delivery_status'pending' | 'delivered' | 'failed' required
evidence_urlstring nullable required

The saved observation behind the alert, opened in the app after sign-in.

rule_idstring required
testboolean required

True for a synthetic event requested with send_test_alert.

request_idstring

Changes

No recorded changes to this operation across all 1 revision of this API.