{"id":"versioning-breaking-changes","title":"Breaking Changes","section":"versioning","content":"The following changes are considered breaking and require a new API version.","breakingChanges":["Removing or renaming APIs, parameters, or fields","Changing the type of a field","Making optional parameters required","Adding required parameters without defaults","Removing enum values","Changing error codes","Changing URL structure"],"nonBreakingChanges":["Adding new optional fields to responses","Adding new optional query parameters","Adding new endpoints","Adding new HTTP methods on existing endpoints","Adding new enum values (if clients prepared)"]}