Configure Slack Webhook
User
Configure Slack Webhook
Configure Slack notifications for job failures
POST
Configure Slack Webhook
Overview
Configure a Slack incoming webhook to receive notifications when jobs fail. You can choose to receive all failure notifications, errors only (technical failures), or warnings only (content issues like private/unavailable videos). The webhook URL is stored securely and encrypted at rest.Header Parameters
string
required
Your API key for authentication
Request
string
required
Slack incoming webhook URL. Must start with
https://hooks.slack.com/services/.string
default:"all"
Controls which failure types trigger a Slack notification:
all— Both errors and warnings (default)errors_only— Only technical failures (rate limits, bot detection, connection errors)warnings_only— Only content issues (private video, members-only, geo-blocked, unavailable)
Examples
Success Response
Error Responses
If you already have a Slack webhook configured, calling this endpoint again will replace the existing webhook and notify level.
Notification Format
When a job fails, Tornado sends a Slack message with a colored attachment:- Red (
:x:) for technical errors (rate limits, connection issues, bot detection) - Orange (
:warning:) for content warnings (private video, members-only, geo-blocked, unavailable)
Notify Level Reference
What counts as an error vs warning?
Only failed jobs trigger Slack notifications. Completed, pending, and processing jobs do not send any notification to Slack.
