API Design · Senior · Question 8 of 75

Why is changing default behavior (e.g. a default page size) a breaking change?

✓Correct answer: Clients that rely on the old default get different results without changing anything on their side
2Defaults are only used in tests
3Defaults are not part of the API

Explanation

Defaults are part of the contract. Introduce new behavior opt-in or under a new version.

Further reading

Test yourself

Take the API Design · Senior quiz: questions and options are shuffled, and you get a review of your mistakes at the end.