changed API function name for clarity.