I think we need to standardize how we document required & optional parameters.  We did something different in the reseller purchase api.  This is not necessarily for this PR, but needs to be addressed.