It would be safer to just leave the mode property from the instance, but in most cases the implementation would just ignore it. In case of doubt check the swagger documentation of the PATCH action.

Learn the best ways to document your RESTful API versioning and deprecation policies, and why they are important for your API's usability and maintainability.

RESTful API documentation is expensive to produce and maintain due to the lack of reusable tools and automated solutions. Most RESTful APIs are documented manually and the API developers are ...

This also included the release of new REST APIs. One thing that many noticed —competitor Stripe’s REST API documentation looks remarkably similar.