add description for both endpoints, readable by lout