[SD-1474] - Fix User Create & Update actions on Platform API

[MatthewKennedy]

• Allow params :password and :password_confirmation.
• Document passing request body with attributes nested inside user object.
• Small changes for swagger docs validations.

[viezly]

Changes preview:

Legend:

👀 Review pull request on Viezly

[MatthewKennedy]

@damianlegawiec
A couple of thoughts regarding the swagger docs schemas:

1. We should really update all of the request schemas in swagger_halper.rb to show being passed nested inside a json object with the key pertaining to the resource intended.
2. We should also allow the optional use of a separate request body params schema for create and update, this is because params marked as required are not required for the update most of the time, and some resources (those with single table inheritance using a type), the attributes to update the fields on the type are not available until after the create and the type is defined.

[damianlegawiec]

@damianlegawiec A couple of thoughts regarding the swagger docs schemas:

1. We should really update all of the request schemas in swagger_halper.rb to show being passed nested inside a json object with the key pertaining to the resource intended.
2. We should also allow the optional use of a separate request body params schema for create and update, this is because params marked as required are not required for the update most of the time, and some resources (those with single table inheritance using a type), the attributes to update the fields on the type are not available until after the create and the type is defined.

Aggree & Agree!