new functions in API and tests