add some helper logic around API request
I encountered some error states when a user manually calls API request, and wanted to avoid those
bump version'