More endpoint docs/clarifications