path versus body convention in APIs

[eric-jahn]

We need to set an api convention that were don't have parameters in the request body when they are already in the path variable. Having both can cause issues, as we've seen. Like, if they are inconsistent, or if they are critical but not enforced in the body, etc... Thus issue should be removed from all our apis.