API Design · Middle · Question 74 of 75

Why does a stable `operationId` in OpenAPI matter?

✓Correct answer: Generators use it for SDK method names; changing it renames client methods and breaks code even if the HTTP API didn't change
2It's required by HTTP
3It's the URL of the endpoint

Explanation

Treat operation IDs and schema names as part of the public contract when you publish SDKs.

Further reading

OpenAPI Specification ↗

Test yourself

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