ENGINEERING

Alert downstream teams when a new API spec is published

When a new version of the OpenAPI spec is released, diff it against the previously published version and notify each consuming team in Slack with only the changes that touch…

CategoryEngineering
Enginesim
Difficultyintermediate
Triggerwebhook
Steps5
Setup~15 min

How it runs

The automated pipeline, trigger to output.

  • TriggerNew spec version publishedHTTP webhook
  • ActionLoad new and prior published specsShell
  • ActionDiff specs into per-path change listShell
  • LogicFilter to teams with relevant changes
  • OutputPost scoped change notice per teamSlack

What it does

Turns a spec release into targeted change notices. Instead of broadcasting a full changelog to everyone, it diffs the newly published spec against the last one and routes a per-team Slack message containing only the changed paths each team consumes.

When to use it

Use this when many internal services depend on one shared API and a generic "new version is out" announcement gets ignored. Scoping the message to a team's own dependencies makes the alert actionable and raises the odds they update before the next breaking release.

How it works

  1. 1A spec-published webhook fires (from your release pipeline or registry).
  2. 2The flow loads the new spec and the previously published version.
  3. 3A shell step diffs the two and produces a per-path change list.
  4. 4It joins changed paths against a consumer registry mapping paths to owning teams and Slack channels.
  5. 5A logic branch drops teams with no relevant changes.
  6. 6For each remaining team, it posts a scoped Slack message naming the changed endpoints and whether each change is breaking.

Set it up

What you configure once, before turning it on.

  1. 1
    Connect HTTP webhookTrigger any URL on agent actions.
  2. 2
    Connect ShellRun sandboxed commands inside the workspace.
  3. 3
    Connect SlackChannels, DMs, threads, mentions.
  4. 4
    Set each agent's modelWe leave models unset so you pick the tier — fast + cheap, or top-quality.
  5. 5
    Tune it to your dataEdit the prompts, filters, and field mappings so it matches how your team works.
  6. 6
    Test, then turn it onRun once against a sample, confirm the output, then enable the trigger.

Run this workflow in your colony.

14-day trial. No DevOps. No Sales call. Provisioned in under a minute.