Hi, I see what you mean: the current Swagger spec does not include information about read-only and required properties; moreover, the class inheritance (enforced by Jackson as the "@class" property) is not clearly documented.
I have opened https://issues.apache.org/jira/browse/SYNCOPE-1274 to track this work. For example, the sample value for POST /users (e.g. user create) would change from { "creator": "string", "creationDate": "2018-02-11T14:19:38.905Z", "lastModifier": "string", "lastChangeDate": "2018-02-11T14:19:38.905Z", "key": "string", "type": "string", "realm": "string", "status": "string", "password": "string", "token": "string", "tokenExpireTime": "2018-02-11T14:19:38.905Z", "username": "string", "lastLoginDate": "2018-02-11T14:19:38.905Z", "changePwdDate": "2018-02-11T14:19:38.905Z", "failedLogins": 0, "securityQuestion": "string", "securityAnswer": "string", "suspended": true, "mustChangePassword": true } to { "realm": "string", "@class": "org.apache.syncope.common.lib.to.UserTO", "password": "string", "username": "string", "securityQuestion": "string", "securityAnswer": "string" } HTH Regards. -- Sent from: http://syncope-user.1051894.n5.nabble.com/
