adding a warning about exposing this in the API