added API Docs and updated schema