api specs improved