minor additions to example API