facilitate including instance generator software info
change URL in schema 's
refactor some definitions into a separate file and add schemas for API endpoints