Apart from what I noted down in code, these are the things I noted when using the API

• The name property is not described in the schema
• firstName and lastName are described as non writable
• The password property is described although it does not exist on the user resource
• Attributes turn up in the form's payload although they are not writable (e.g. name):

• The property email has the key mail in the schema

• In the API description, the :id part is missing from the routes:
  

• In the API description, the schema example seems to be malformed:

• The endpoint for user update is wrong (lacking the {id} part)

👍

Thanks for fixing the user API description along the way.