first commit of api spec

Since we don't have answers to these questions yet, and we want to get a basic API and frontend in place before we start work on handling images, maybe it's best to remove the reference to JPG on line 17 above.