board Public API · No endpoint to test an alert channel
The UI has a "Test alert channel" button on the channel edit screen and it works. There is no API equivalent.
Of the 138 paths in https://api.checklyhq.com/openapi.json, the entire alert-channel surface is GET/POST /v1/alert-channels, DELETE/GET/PUT /v1/alert-channels/{id}, PUT /v1/alert-channels/{id}/subscriptions, GET /v1/alert-notifications and GET /v1/check-alerts. I also tried POST /v1/alert-channels/{id}/test, /send-test, /v1/alert-channels/test and /v1/alert-notifications/test. All four return 404.
Why it matters: storing a phone number and subscribing it to 30 checks proves neither that the number is correct nor that the carrier delivers. Until somebody clicks that button by hand, a typo in an E.164 number is indistinguishable from a working channel, and the moment it becomes distinguishable is the outage the channel exists for. A POST /v1/alert-channels/{id}/test would make that a deploy-time assertion instead of a human ritual.
Log in to comment and vote
Comments1
Hervé Labas
Aug 14
Thanks Markus. We have some support for testing alert channels, but not all of them are supported. I’ll keep tabs on this for phones and will get back to this post once we have a more concrete plan.