new options for api functions