{"uid":"cap_7Gps8RpXm9_H1IqKrEz1v","slug":"api-breaking-change-check-520047ab","name":"API Breaking Change Check","description":"API Breaking Change Check for OpenAPI — Compares two versions of one API description (OpenAPI 3.0 or 3.1 in YAML or JSON, or two JSON Schemas of one request or response) and lists ONLY the changes that break clients written against the old version, one line each with a fixed code, the place, old and new, and who breaks - or exactly No breaking changes. The skill judges by direction - a request may widen safely and breaks when it narrows, a response may narrow safely and breaks when it widens - …","url":"https://api.aiskills402.com/v1/skills/api-breaking-change-check/file?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD"],"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_XE4-eHhIB1cXPzMzI3Qck","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Compares two OpenAPI or JSON Schema versions and identifies only backward-incompatible changes that would break existing API clients","exampleAgentPrompt":"Can you check whether my updated API spec breaks any existing clients? Here's my old OpenAPI 3.1 YAML and the new version — I just want a list of the breaking changes only, nothing else.","exampleUseCases":[{"title":"Pre-release API compatibility gate","prompt":"Before I ship this new version of my payment API, compare the old OpenAPI 3.0 spec and the new one and tell me every single breaking change that would hurt clients on the current version."},{"title":"PR review for API schema changes","prompt":"My teammate just updated our OpenAPI 3.1 spec in this pull request — can you compare it against the main branch version and flag only the breaking changes so I know if it's safe to merge?"},{"title":"Catch breaking response field removals","prompt":"I redesigned our user profile endpoint response schema — here's the old JSON Schema and the new one. List any breaking changes where fields were removed or narrowed that would break existing API consumers."}],"resultDescription":"A plain-text or structured list of breaking changes, each on its own line with: a fixed machine-readable change code, the location in the spec where the break occurs, the old value, the new value, and which party (client or server) is affected. If no breaking changes are found, returns exactly 'No breaking changes'.","failureModes":["Invalid or unparseable YAML/JSON input returns a parse error","Specs that are not OpenAPI 3.0/3.1 or valid JSON Schema are rejected","Missing required HTTP method or type in input schema returns 400","Payment not received or insufficient USDC balance returns 402","Timeout if spec files are excessively large"],"whenToPreferThis":"Choose this endpoint when you need a focused, opinionated breaking-change-only diff between two OpenAPI 3.0/3.1 or JSON Schema documents. Unlike general diff tools, it applies API semantic rules (requests may widen, responses may narrow) and suppresses non-breaking changes, giving a clean actionable list. Ideal for CI gates, PR reviews, and pre-release validation workflows where only client-breaking changes matter.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T12:30:17.090Z","isFirstParty":false,"canonicalSlug":"api-breaking-change-check-520047ab"}