Glossary

Breaking change (API)

An API breaking change is a modification that causes existing clients — written against the previous API version — to fail, produce incorrect results, or require code changes to continue functioning. Common examples: removing a response field, changing a type, renaming an endpoint, making an optional parameter required, or altering error semantics. Adding optional fields is often non-breaking if clients ignore unknown fields.

Last updated: March 2026