Document user authentication and associated new api methods