{"uid":"cap_12f_8t5jgOhmdbQuyqkij","slug":"agent402-tools-schema-evolution-drift-check-0b621797","name":"agent402.tools Schema Evolution Drift Check","description":"Bundled execution of the API contract drift check workflow - The 'did this API contract change in a way that breaks our integration?' workflow. Diff two OpenAPI snapshots structurally, lint the new one for agent-readiness regressions, extract the endpoint surface for inventory comparison, validate a known-good payload against the new contract, and summarize security-relevant changes. Six tools, one go/no-go answer on whether the upstream API broke us.","url":"https://agent402.tools/api/skill/schema-evolution","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"newSpec":{"type":"string","description":"the current OpenAPI snapshot as a JSON document (object or JSON string)"},"oldSpec":{"type":"string","description":"the prior OpenAPI snapshot as a JSON document (object or JSON string)"}}},"responseSchema":{"type":"json","example":{"args":{"newSpec":"{\"openapi\":\"3.0.3\",\"info\":{\"title\":\"Orders API\",\"version\":\"1.1.0\"},\"paths\":{\"/v1/orders\":{\"post\":{\"operationId\":\"createOrder\",\"requestBody\":{\"required\":true,\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"required\":[\"customerId\",\"currency\"],\"properties\":{\"customerId\":{\"type\":\"string\"},\"currency\":{\"type\":\"string\"}}}}}},\"responses\":{\"201\":{\"description\":\"created\"}}}}}}","oldSpec":"{\"openapi\":\"3.0.3\",\"info\":{\"title\":\"Orders API\",\"version\":\"1.0.0\"},\"paths\":{\"/v1/orders\":{\"post\":{\"operationId\":\"createOrder\",\"requestBody\":{\"required\":true,\"content\":{\"application/json\":{\"schema\":{\"type\":\"object\",\"required\":[\"customerId\"],\"properties\":{\"customerId\":{\"type\":\"string\"},\"currency\":{\"type\":\"string\"}}}}}},\"responses\":{\"201\":{\"description\":\"created\"}}}}}}"},"pack":"schema-evolution","steps":[{"ok":true,"slug":"openapi-diff","result":{}},{"ok":true,"slug":"openapi-lint","result":{}},{"ok":true,"slug":"openapi-extract","result":{}},{"ok":true,"slug":"openapi-required-params","result":{}},{"ok":true,"slug":"openapi-validate-payload","result":{}},{"ok":true,"slug":"openapi-security-summary","result":{}}],"summary":"6/6 steps succeeded"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.008","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.008/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_aDNk9O2hBhN9CllWXXQ__","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.008","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Diffs two OpenAPI snapshots to detect breaking changes, lint agent-readiness regressions, and extract a structured evolution report for integration maintenance.","exampleAgentPrompt":"Can you check whether our API integration is broken by the latest spec update? Here's the old OpenAPI snapshot and the new one — diff them structurally, flag any breaking changes, and lint the new version for agent-readiness regressions.","exampleUseCases":null,"resultDescription":"Returns a structured report that includes: a structural diff between the two OpenAPI snapshots highlighting added, removed, and modified endpoints or schemas; a list of breaking changes that could break existing integrations; and lint findings on agent-readiness regressions in the new spec.","failureModes":["Invalid or unparseable YAML/JSON in either spec field — returns parse error","Missing oldSpec or newSpec — returns validation error for required fields","Specs that are too large to process within timeout — may return timeout or truncation error","Non-OpenAPI documents submitted as specs — may return schema mismatch or empty diff"],"whenToPreferThis":"Choose this endpoint when you need a bundled, single-call workflow that combines structural diffing, breaking change detection, AND agent-readiness linting in one step. Prefer it over a manual multi-step pipeline when you want a holistic API contract drift report without orchestrating separate tools.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T07:09:38.139Z","isFirstParty":false}