ENGINEERING
Nightly audit of deployed API specs for undocumented breakage
Each night fetches the live OpenAPI spec served by each deployed environment, compares it to the last-known-good snapshot in Postgres.
How it runs
The automated pipeline, trigger to output.
- TriggerNightly schedule fires
- ActionFetch live served spec per environmentHTTP webhook
- ActionLoad approved baseline specPostgres
- LogicDiff each environment for breaking drift
- OutputAlert Teams on drift or refresh baselineMicrosoft Teams
What it does
Catches breaking changes that slipped past code review by inspecting what is actually running. On a schedule it pulls the live spec from each environment's endpoint, diffs it against the approved baseline stored in Postgres, and reports any backward-incompatible drift, including changes from out-of-band hotfixes or config.
When to use it
Use it when specs can change at runtime or when you do not fully trust merge-time gates, and you want a safety net that verifies deployed reality against the contract every night.
How it works
- 1A nightly schedule starts the run.
- 2For each environment, the workflow fetches the served OpenAPI spec over HTTP.
- 3It loads the last-approved baseline spec for that environment from Postgres.
- 4A diff-and-classify step checks each environment for breaking drift.
- 5If any environment drifted incompatibly, it sends a Microsoft Teams alert naming the environment and changes; otherwise it updates the baseline snapshot.
Set it up
What you configure once, before turning it on.
- 1Connect HTTP webhookTrigger any URL on agent actions.
- 2Connect PostgresAny Postgres URL — query, write, migrate.
- 3Connect Microsoft TeamsChannels, chats, files.
- 4Set each agent's modelWe leave models unset so you pick the tier — fast + cheap, or top-quality.
- 5Tune it to your dataEdit the prompts, filters, and field mappings so it matches how your team works.
- 6Test, then turn it onRun once against a sample, confirm the output, then enable the trigger.
More Engineering workflows
Upgrade Impact Router to Module Code Owners
Maps a dependency-bump PR's affected modules to their CODEOWNERS, then DMs each owner on Slack with only the changelog slice that touches code they own.
Re-Voice IVR Prompts on Phone-Tree Config Merge
When a phone-tree config change merges in GitHub, regenerates the ElevenLabs audio for any prompt whose script changed in the diff and opens a follow-up PR adding the new audio…
Agent reviews model-license fit and suggests compliant swaps on the PR
When a PR adds a Hugging Face model, an agent reads the model card and license, judges fit against your commercial-use policy.
Scan for deprecated endpoints and email consumers a weekly sunset countdown
On a weekly schedule, scans the OpenAPI spec for endpoints marked deprecated with a sunset date, and emails each consuming team a countdown of how many days remain before removal.
Publish a versioned API changelog to Confluence on each release tag
On a new semver release tag, gathers the contract changes since the last release and writes a clean.
Gate breaking API PRs behind downstream consumer acknowledgement
When a PR introduces a breaking contract change, comments the impact summary back on the PR, applies a blocking label.
Run it inside a business
This workflow drops into a full company template. Import the org, and this is one of the playbooks its agents run.
Run this workflow in your colony.
14-day trial. No DevOps. No Sales call. Provisioned in under a minute.