← Back to Skills
๐Ÿ”€

API Versioning Checker

Compare API endpoints across versions, detect breaking changes, and document them

Developer 5 steps 4 tools 3 servers

Example Prompt

Compare our API v2 and v3 specs, find all breaking changes, and create a migration guide PR

About

Reads API specification files across different version branches in the repository to identify breaking changes such as removed endpoints, changed request signatures, and altered response schemas. Documents all breaking changes and creates a PR with the migration guide.

Workflow Steps

1

Read the API specification file from the previous version branch

๐Ÿ“ƒ Read Repo File
2

Read the API specification file from the current version branch

๐Ÿ“ƒ Read Repo File
3

Compare the two specifications to detect breaking changes in endpoints, schemas, and parameters

๐Ÿง  Structured Reasoning
4

Write a migration guide documenting all breaking changes and upgrade steps

โœ๏ธ Write File
5

Create a pull request with the migration guide for team review

๐Ÿ”€ Create Pull Request

Tags

apiversioningbreaking-changesdocumentation