Improve current API schema

[alekhinen]

Auto-generate API schemas and/or Improve current API schema and remove unnecessary parts.

• Our comma delimited lists can just become real attributes and flags now.
• No need to have our objects wrapped in an extra dictionary.