Thanks for this - we’ve made this clear in the Ads API docs, but not so much in the rest of the documentation so far. As more of the endpoints move towards a JSON body this will become more common. We’ve made a note to clarify, and apologise for the confusion here.