adding changes and some commentary to the REST API request