adding more documentation around indices API operations