Is your feature request related to a problem? Please describe.
REST API documentation, and hence python client generated out of it, suffers from poor structure of update API.
OpenAPI supports Enums with structures poorly, so the readability of the documentation suffers.
Collection and point update endpoints are not clear enough.
It might be hard to find required operation in the OpenAPI Schema.
It would be useful to create additional REST endpoints for all point update method variants
Describe the solution you'd like
Describe alternatives you've considered
Write better documentation
Additional context
Based on discussion in ODS.ai