Update deprecations as per Joakim and Claes
Rename path parameter from id/userId/email to userId

Only userId is actually supported.
Add notes on APIs to possibly go undocumented