Changes management

Tracking API changes is essential, both for API builders and consumers.

What is a change #

A change is a modification of your API with an impact on its behavior. Changes are differentiated into various categories:

Documentation change a description is modified
Structural change the structure of the API is modified
Breaking change a major change in your API requires an update to the code consuming it

How to manage and track changes #

Changelog is a crucial feature of, recording the history of all deployments and detailing changes compared to previous versions.

The changes comparison allows you to compare two deployed API definitions, regardless of differences in dates or branches. offers various notification options, whether it’s integration into your existing workflows or email notifications, you can be confident that you’ll stay informed about important changes.