i assume its save to say that nobody is calling this API method directly? otherwise adding new arguments here could be tricky (if someone were to use position arguments vs. keywords)

@abunsen @igorgue