updated endpoint docs