minor API URL tweak to make swagger happier
cleanup of help text for API