Breaking Changes

Learn about recent and upcoming breaking changes to the Defined GraphQL API.

About breaking changes

Breaking changes are any changes that might require action from customers. We divide these changes into two categories:

Breaking: Changes that will break existing queries to the GraphQL API. For example, removing a field would be a breaking change.

Dangerous: Changes that won't break existing queries but could affect the runtime behaviour of clients. Adding an enum value is an example of a dangerous change.

We strive to provide stable APIs for our integrators. When a new feature is still evolving, we release it behind a schema preview.

We'll announce upcoming breaking changes at least three months before making changes to the GraphQL schema, to give integrators time to make the necessary adjustments.


Join our Discord

Ask questions, share what you're working on and request new features πŸ‘¬πŸ‘­