improved docs for manager endpoint