I really like the idea that requests is responsible for dealing with the keyword arguments of these methods and not adding any additional, duplicate restrictions on our side. On the other hand, this makes knowing how demands works dependent on knowing how requests works. For lack of a better solution, I'd recommend going with Doug's change and also adding nice docstrings to these methods.