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.

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 ...

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.

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