The field was renamed three times and the frontend never found out
The field changed in code, in chat, and in the HTTP client while the docs waited for someone to care. A local OpenAPI file in version control gives the whole team one contract to diff, review, and trust.