While I agree this is useful, I want to keep the description of the format of the request entities outside the SDK. This way if a change is made in the master API guide I don't need to update the SDKs. We'll fix this in the API guide.