move api spec into the readme