SpecWatch

Dependabot for every API you call — plus CI gates for the ones you ship

Know before
it breaks.

Third-party APIs add required fields, narrow enums, and drop endpoints without asking you. SpecWatch polls OpenAPI, GraphQL, AsyncAPI, Postman, and docs every 10 minutes — sending deterministic, plain-English alerts to Slack, Discord, and email before 500s reach production.

Stripe · GitHub · OpenAI · Twilio · Slack · Supabase · Cloudflare · Square · Plaid — watched out of the box, or paste any URL. No credit card.

stripe/openapi-spec3.yamlwatching · poll #418
1openapi: 3.1.0
2paths:
3 /v1/payment_intents:
4 post:
5 summary: Create a payment intent
6 parameters:
7 - name: amount
8 required: [amount]- removed
9 required: [amount, customer]+ added
10 - name: customer
11

severity

BREAKING

breakingstripe · 4 min ago

Creating a payment intent now requires a customer ID. Calls without one will start failing.

The status quo

Today, your error tracker is your API changelog reader.

The unread changelog

Every vendor publishes release notes somewhere. Nobody on a 5-person engineering team has time to read nine of them daily.

The 2 a.m. pager alert

Sentry wakes you up after a newly-required field or narrowed enum starts throwing 500s on live customer checkouts.

The post-mortem archaeology

Hours burned grepping forum threads and raw OpenAPI commits to figure out what upstream contract silently shifted.

YC notes over 30% of cloud service incidents at one point traced back to unnoticed upstream API and dependency changes. The contract changed in public — nobody was diffing it.

The shift

Deterministic rules judge severity.
Plain English tells you what to fix.

- paths./charges.post.parameters[4]

- required: [amount]

+ required: [amount, customer]

- components.Charge.currency: string

+ components.Charge.currency: enum

// 400 lines of raw schema churn per vendor release

breaking · majorstripe · detected in 10m poll

Creating a payment intent now requires a customer ID, and currency now only accepts a fixed enum. Pass customer on checkout requests before upgrading API versions.

The engine

Zero vendor cooperation. Zero hallucinated severity alerts.

01

Poll politely (10m)

Conditional ETag / If-Modified-Since GETs check every watched spec, GraphQL endpoint, or docs URL every 10 minutes — zero vendor setup.

02

Normalize & Diff

Resolves $refs, strips volatile x- metadata noise, and runs a structural contract diff against the last known-good snapshot.

03

Classify Deterministically

Hard SemVer rules judge severity (major / minor / patch) — never an LLM guess. AI only translates JSON paths into plain English.

04

Alert & Gate CI

Routes breaking alerts to Slack, Discord, email, and RSS within minutes — or blocks breaking internal PRs in GitHub Actions.

Rely on a niche partner API? Paste any URL — SpecWatch probes the contract format automatically and flags weak client-rendered docs honestly.

Precision API breaking-change gate
npm run diff:cli -- ci main/openapi.yaml openapi.yaml
EXIT 1 · MAJOR

Optic-Grade CI Gate, Governance Linter & PR Comments

Protect your own consumers before merge — classify SemVer bumps (major/minor/patch), enforce Spectral governance rules, post GitHub PR summaries via POST /api/ci/diff, and publish changelog.md.

High-frequency conditional API polling
ETag / 304 Conditional Pollevery 10m

Slack, Discord, Email & RSS Routing

Auto-detects Slack Block Kit and Discord webhooks out of the box so breaking upstream changes land directly in your team's incident or #integrations channel within minutes.

Universal coverage

From Stripe's OpenAPI spec to a niche partner's HTML docs.

Most third-party APIs never publish a textbook OpenAPI file. SpecWatch watches six contract formats — with transparent signal-strength ratings so you always know how deep the diff runs.

OpenAPI / Swagger

Strongest

Removed endpoint, narrowed enum, or newly-required parameter = breaking ($refs resolved).

GraphQL (SDL + Live)

Strongest

Static SDL or live POST { __schema } introspection. Removed field or type mutation = breaking.

AsyncAPI

Strongest

Event-driven contracts. Removed channel, message payload key, or operation = breaking.

Postman Collections

Strong

Diffs endpoint & payload inventories straight from public vendor collections.

Generic JSON / YAML

Strong

Watches partner JSON Schemas or config manifests for disappearing required keys.

Docs-only APIs

Baseline

No machine spec? Section-level documentation diffing catches silent reference edits.

Verifiable proof

No staged screenshots. Every public vendor catch is live.

StripeGitHubOpenAITwilioSlackSupabaseCloudflareSquarePlaid

Every change our engine detects on public vendors lands directly on /changes and /changes/rss.xml — the exact same detections Pro and Team subscribers get alerted on. Inspect the live feed before signing up.

Pricing

Cheaper than ten minutes of checkout downtime.

Watch your 3 most critical vendor APIs free forever. Upgrade to $19/mo when you want 10-minute polling, Slack/Discord routing, and CI gates.

Free$0 forever
  • Watch up to 3 APIs (all 6 source types)
  • Weekly plain-English change digest
  • Deterministic breaking classification
  • Local CLI & live public /changes feed
Watch 3 APIs free
Pro$19 /month
  • Unlimited public & private custom APIs
  • 10-minute polling + within-minutes email alerts
  • Slack & Discord webhook routing
  • CI/CD SemVer gate & GitHub PR comments
  • Spectral-style API governance linter
Get alerts in minutes
Team$49 /month
  • Everything in Pro
  • Shared team watchlist & per-vendor routing
  • Live GraphQL introspection endpoints
  • Auto-published Markdown & RSS changelogs
Protect your team

Free forever for 3 APIs. Paid plans billed via Polar (merchant of record) · cancel in one click.