Back to API overview
Alerts

Subscribe to alerts

POST/v1/alerts/subscriptions Bearer API key

Get notified when a mission crosses a risk threshold or detects a significant change.

Alert subscriptions watch a mission and fire when a condition is met — a risk score crossing a threshold, a detected change, or a completed cycle. Choose a delivery channel and a threshold; alerts can also be delivered via webhooks.

Request body

mission_idrequiredstring

The mission to watch.

conditionrequiredstring

Trigger condition, e.g. risk_score>0.7.

channelrequiredstring

Delivery channel: email, webhook, or slack.

Response fields

idoptionalstring

Subscription identifier.

statusoptionalstring

active or paused.

curl -X POST https://api.satellitex.ai/v1/alerts/subscriptions \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "mission_id": "msn_7c3d",
    "condition": "risk_score>0.7",
    "channel": "webhook"
  }'

Illustrative API — keys and identifiers are for demonstration.

Related endpoints

Ready to build with this?

Request access and we'll help you scope your first mission and provision API keys.

Request API access