Authentication
All webhook endpoints require a valid session token:GET /api/alerts/webhook-config
Retrieve the current webhook configuration status.Response
Whether Discord webhook URL is configured
Whether Slack webhook URL is configured
POST /api/alerts/webhook-config
Update webhook configuration. URLs are stored securely in the credential vault.Request Body
Discord webhook URL (must be HTTPS). Set to
null or empty string to remove.Slack webhook URL (must be HTTPS). Set to
null or empty string to remove.At least one of
discord_url or slack_url must be provided in the request.Response
Returns
true if configuration was saved successfullyUpdated Discord configuration status
Updated Slack configuration status
POST /api/alerts/webhook-test
Test webhook delivery by sending a test message.Request Body
Specific provider to test:
discord or slack. If omitted, tests all configured webhooks.Custom test message. Defaults to a timestamp-based test message.
Response
Overall test result:
true if at least one configured webhook was sent successfullyWhether any webhooks are configured
Array of test results per provider
Error Responses
- 400 Bad Request: Invalid URL, missing required fields, or invalid provider name
- 401 Unauthorized: Missing or invalid session token
- 500 Internal Server Error: Failed to save webhook configuration or vault error