{"uid":"cap_G4BKY7a5ME6QAp-NX6Ylk","slug":"library-version-delta-changelog-breaking-change-detector-7f7de017","name":"Library Version-Delta Changelog & Breaking Change Detector","description":"Version-delta changelog for a library between two versions. Give an ecosystem, package name and from_version and to_version and get the GitHub release notes in that range, the registry versions between them, and surfaced breaking-change markers. Built for agents deciding whether an upgrade is safe.","url":"https://api.agentstools.dev/docs/changelog?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","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["name","ecosystem","from_version","to_version"],"properties":{"name":{"type":"string","description":"Package name; for github pass owner/repo such as coinbase/x402. npm scoped names @scope/name are allowed."},"ecosystem":{"enum":["npm","pypi","crates","github"],"type":"string","description":"Package ecosystem. Aliases accepted: pip and python map to pypi; cargo and rust map to crates; node maps to npm; gh maps to github."},"to_version":{"type":"string","description":"Upper bound version, such as 19.0.0 (inclusive)."},"from_version":{"type":"string","description":"Lower bound version, such as 18.0.0 (exclusive)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"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":{"p10Cents":"0.8000","medianCents":"0.8000","p90Cents":"0.8000","minCents":"0.8000","maxCents":"0.8000","p95Cents":"0.8000","sampleCount":1,"varies":false,"failureChargeRate":1},"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_okQ690shBMRZpX1tMM9Sp","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":"Returns GitHub release notes, registry version list, and breaking-change markers between two versions of an npm, PyPI, crates.io, or GitHub package.","exampleAgentPrompt":"Can you check if upgrading react on npm from version 18.0.0 to 19.0.0 is safe — fetch the changelog delta and flag any breaking changes in that range?","exampleUseCases":null,"resultDescription":"A structured response containing: GitHub release notes for all releases between the two specified versions, a list of registry versions in that range, and any surfaced breaking-change markers (e.g. major version bumps, BREAKING CHANGE commit prefixes, or explicit notes in release bodies). Helps the agent decide whether an upgrade is low-risk or requires code changes.","failureModes":["Package not found in the specified ecosystem — returns error indicating unknown package","Invalid version string format — returns validation error","from_version is equal to or newer than to_version — returns empty range or error","No GitHub releases exist for the version range — returns empty release notes with versions only","Rate limiting or upstream registry/GitHub API unavailability — returns 5xx or timeout","Unsupported ecosystem value passed — returns enum validation error"],"whenToPreferThis":"Use this endpoint when an AI agent needs to reason about dependency upgrades — specifically when it must assess changelog content and breaking-change risk between two specific semver versions of a known package on npm, PyPI, crates.io, or GitHub. Prefer this over generic web search when you need structured, parsed release notes and breaking-change markers rather than raw HTML documentation pages.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T00:34:16.624Z","isFirstParty":false,"canonicalSlug":"library-version-delta-changelog-breaking-change-detector-7f7de017"}