Feature/api specs

@mtakac should this still be pending?