ENGINEERING

Alert dependent service owners when an API breaks

When a breaking OpenAPI change merges, looks up which downstream services consume the affected endpoints and DMs each service owner in Microsoft Teams with the exact fields…

CategoryEngineering
Enginesim
Difficultyintermediate
Triggerevent
Steps5
Setup~15 min

How it runs

The automated pipeline, trigger to output.

  • TriggerPush to main changes the API specGitHubGitHub
  • ActionDiff spec and extract broken endpoint pathsGitHubGitHub
  • ActionQuery dependency registry for consuming servicesPostgreSQLPostgres
  • LogicGroup breaks by owning team
  • OutputDM each affected owner in Microsoft TeamsMicrosoft Teams

What it does

Turns a merged breaking change into targeted, actionable warnings. After an API spec change lands on the main branch, it identifies the endpoints that broke, queries a dependency registry for the services that call those endpoints, and notifies each owning team in Microsoft Teams individually rather than spamming one shared channel.

When to use it

Use it in a multi-team org where several services depend on a shared API and you need owners to find out the moment a contract changes, not when their integration starts failing in production.

How it works

  1. 1A push to the default branch with a changed spec triggers the run.
  2. 2The workflow diffs the spec and extracts the list of broken or removed endpoint paths.
  3. 3It queries a Postgres dependency registry mapping endpoints to consuming services and their owners.
  4. 4For each affected service it composes a per-owner message with the changed fields and a migration deadline.
  5. 5It sends a direct Microsoft Teams message to each owner.

Set it up

What you configure once, before turning it on.

  1. 1
    Connect GitHubRepos, issues, pull requests, actions.
  2. 2
    Connect PostgresAny Postgres URL — query, write, migrate.
  3. 3
    Connect Microsoft TeamsChannels, chats, files.
  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.