RunVouchGet a free key

Docs › Slack

Slack

RunVouch posts to the Slack channel you choose when a scheduled job or AI agent is MISSED, FAILED, NO_EVIDENCE, STALLED, RETRY_STORM, BUDGET_RUN, BUDGET_DAY or DRIFT, plus a weekly digest. Works on every plan, including Free. Two ways in: the Add to Slack button below, or paste an incoming webhook URL yourself.

On this page
  1. Add to Slack
  2. Or paste a webhook yourself (every plan)
  3. What lands in the channel
  4. Test and remove

Add to Slack

Enter your RunVouch API key (it stays in your browser; the link only carries it to RunVouch, never to Slack), click the button, pick a channel in Slack, done. RunVouch stores the channel's webhook and posts a first message so you can see it works.

Add to Slack

Checking whether the Slack app is enabled...

Behind the button: GET https://api.runvouch.com/integrations/slack/install?token=YOUR_KEY redirects to Slack's consent screen with the single scope incoming-webhook. Slack sends the browser back to https://api.runvouch.com/integrations/slack/callback; RunVouch exchanges the code, saves the webhook URL on your account and posts a connected message. RunVouch never reads messages from your workspace.

Or paste a webhook yourself (every plan)

In Slack: Apps, Incoming Webhooks, add to a channel, copy the URL. It starts with https://hooks.slack.com/services/; other URLs are rejected with 422.

curl -X PUT https://api.runvouch.com/v1/settings -H "X-API-Key: $RUNVOUCH_KEY" -H "Content-Type: application/json" \
  -d '{"slack_webhook_url": "https://hooks.slack.com/services/T000/B000/XXXX"}'

Or paste it in the Slack field on the dashboard. Both routes end with the same field on your account; the last one written wins.

What lands in the channel

Each alert is one message with a plain-text fallback plus blocks: a header with kind and agent, two fields (kind, agent), the message (for FAILED the stderr excerpt, for BUDGET the cost and the cap), and a link to the dashboard. The weekly digest per account goes to the same channel.

RunVouch MISSED: nightly-report
Kind    MISSED          Agent   nightly-report
cadence 24h + grace 30m passed without a start
Open the dashboard

Alerts of the same kind for the same agent are sent at most once per 10 minutes; on Solo and Team, MISSED and FAILED skip that cooldown. Details on alert channels.

Test and remove

curl -X POST https://api.runvouch.com/v1/settings/test-alert -H "X-API-Key: $RUNVOUCH_KEY"

A TEST alert must land in the channel within a few seconds. To disconnect: remove the RunVouch app from the channel in Slack (Slack revokes the webhook), or overwrite slack_webhook_url with a new one.

Scope and data: the app asks for incoming-webhook only. RunVouch stores one webhook URL per account and sends alerts to it; it holds no Slack tokens, member names or message history. See the privacy policy and security page.

Need a key? Get a free key · Stuck? contact