first commit of api spec

Agreed :pineapple: