adjusted api description