Feature/api specs

@myabc yes - it's not done.