Skip to Content

Alert Channels

Configure external notification channels for deployment events, backup status, and other platform events.

Endpoints

MethodPathDescription
GET/api/v1/settings/alertsList alert channels
POST/api/v1/settings/alertsCreate alert channel
GET/api/v1/settings/alerts/:idGet channel by ID
PUT/api/v1/settings/alerts/:idUpdate channel
DELETE/api/v1/settings/alerts/:idDelete channel
POST/api/v1/settings/alerts/:id/testSend test notification

POST /api/v1/settings/alerts

{ "name": "Slack Deploys", "type": "slack", "config": { "webhook_url": "https://hooks.slack.com/services/T00/B00/xxx" }, "events": [ "deployment.success", "deployment.failure", "backup.success", "backup.failure" ] }

Channel Types

TypeConfig Fields
slackwebhook_url
discordwebhook_url
emailrecipients (array of emails)
telegrambot_token, chat_id
webhookurl, secret (optional)
pushNo config required (uses registered devices)

Event Types

EventDescription
deployment.successDeployment completed successfully
deployment.failureDeployment failed
backup.successBackup completed successfully
backup.failureBackup failed
Last updated on