huggingface-hub 0.22.2__py3-none-any.whl → 0.23.0__py3-none-any.whl

huggingface_hub/hf_api.py

@@ -104,7 +104,7 @@ from .constants import (
 from .file_download import HfFileMetadata, get_hf_file_metadata, hf_hub_url
 from .repocard_data import DatasetCardData, ModelCardData, SpaceCardData
 from .utils import (  # noqa: F401 # imported for backward compatibility
-    IGNORE_GIT_FOLDER_PATTERNS,
+    DEFAULT_IGNORE_PATTERNS,
     BadRequestError,
     EntryNotFoundError,
     GatedRepoError,
@@ -130,7 +130,7 @@ from .utils import (  # noqa: F401 # imported for backward compatibility
     validate_hf_hub_args,
 )
 from .utils import tqdm as hf_tqdm
-from .utils._deprecation import _deprecate_arguments, _deprecate_method
+from .utils._deprecation import _deprecate_arguments
 from .utils._typing import CallableT
 from .utils.endpoint_helpers import (
     DatasetFilter,
@@ -500,10 +500,10 @@ class RepoFile:
         lfs (`BlobLfsInfo`):
             The file's LFS metadata.
         last_commit (`LastCommitInfo`, *optional*):
-            The file's last commit metadata. Only defined if [`list_files_info`], [`list_repo_tree`] and [`get_paths_info`]
+            The file's last commit metadata. Only defined if [`list_repo_tree`] and [`get_paths_info`]
             are called with `expand=True`.
         security (`BlobSecurityInfo`, *optional*):
-            The file's security scan metadata. Only defined if [`list_files_info`], [`list_repo_tree`] and [`get_paths_info`]
+            The file's security scan metadata. Only defined if [`list_repo_tree`] and [`get_paths_info`]
             are called with `expand=True`.
     """
 
@@ -603,7 +603,7 @@ class ModelInfo:
             Is the repo gated.
             If so, whether there is manual or automatic approval.
         downloads (`int`):
-            Number of downloads of the model.
+            Number of downloads of the model over the last 30 days.
         likes (`int`):
             Number of likes of the model.
         library_name (`str`, *optional*):
@@ -707,7 +707,14 @@ class ModelInfo:
         )
         self.spaces = kwargs.pop("spaces", None)
         safetensors = kwargs.pop("safetensors", None)
-        self.safetensors = SafeTensorsInfo(**safetensors) if safetensors else None
+        self.safetensors = (
+            SafeTensorsInfo(
+                parameters=safetensors["parameters"],
+                total=safetensors["total"],
+            )
+            if safetensors
+            else None
+        )
 
         # backwards compatibility
         self.lastModified = self.last_modified
@@ -749,7 +756,7 @@ class DatasetInfo:
             Is the repo gated.
             If so, whether there is manual or automatic approval.
         downloads (`int`):
-            Number of downloads of the dataset.
+            Number of downloads of the dataset over the last 30 days.
         likes (`int`):
             Number of likes of the dataset.
         tags (`List[str]`):
@@ -1192,12 +1199,61 @@ class User:
             Name of the user on the Hub (unique).
         fullname (`str`):
             User's full name.
+        is_pro (`bool`, *optional*):
+            Whether the user is a pro user.
+        num_models (`int`, *optional*):
+            Number of models created by the user.
+        num_datasets (`int`, *optional*):
+            Number of datasets created by the user.
+        num_spaces (`int`, *optional*):
+            Number of spaces created by the user.
+        num_discussions (`int`, *optional*):
+            Number of discussions initiated by the user.
+        num_papers (`int`, *optional*):
+            Number of papers authored by the user.
+        num_upvotes (`int`, *optional*):
+            Number of upvotes received by the user.
+        num_likes (`int`, *optional*):
+            Number of likes given by the user.
+        is_following (`bool`, *optional*):
+            Whether the authenticated user is following this user.
+        details (`str`, *optional*):
+            User's details.
     """
 
     # Metadata
     avatar_url: str
     username: str
     fullname: str
+    is_pro: Optional[bool] = None
+    num_models: Optional[int] = None
+    num_datasets: Optional[int] = None
+    num_spaces: Optional[int] = None
+    num_discussions: Optional[int] = None
+    num_papers: Optional[int] = None
+    num_upvotes: Optional[int] = None
+    num_likes: Optional[int] = None
+    is_following: Optional[bool] = None
+    details: Optional[str] = None
+
+    def __init__(self, **kwargs) -> None:
+        self.avatar_url = kwargs.get("avatarUrl", "")
+        self.username = kwargs.get("user", "")
+        self.fullname = kwargs.get("fullname", "")
+        self.is_pro = kwargs.get("isPro")
+        self.num_models = kwargs.get("numModels")
+        self.num_datasets = kwargs.get("numDatasets")
+        self.num_spaces = kwargs.get("numSpaces")
+        self.num_discussions = kwargs.get("numDiscussions")
+        self.num_papers = kwargs.get("numPapers")
+        self.num_upvotes = kwargs.get("numUpvotes")
+        self.num_likes = kwargs.get("numLikes")
+        self.user_type = kwargs.get("type")
+        self.is_following = kwargs.get("isFollowing")
+        self.details = kwargs.get("details")
+
+        # forward compatibility
+        self.__dict__.update(**kwargs)
 
 
 def future_compatible(fn: CallableT) -> CallableT:
@@ -1251,9 +1307,11 @@ class HfApi:
         directly at the root of `huggingface_hub`.
 
         Args:
-            token (`str` or `bool`, *optional*):
-                Hugging Face token. Will default to the locally saved token if not provided.
-                Pass `token=False` if you don't want to send your token to the server.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
             library_name (`str`, *optional*):
                 The name of the library that is making the HTTP request. Will be added to
                 the user-agent header. Example: `"transformers"`.
@@ -1316,14 +1374,16 @@ class HfApi:
         return self._thread_pool.submit(fn, *args, **kwargs)
 
     @validate_hf_hub_args
-    def whoami(self, token: Optional[str] = None) -> Dict:
+    def whoami(self, token: Union[bool, str, None] = None) -> Dict:
         """
         Call HF API to know "whoami".
 
         Args:
-            token (`str`, *optional*):
-                Hugging Face token. Will default to the locally saved token if
-                not provided.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
         """
         r = get_session().get(
             f"{self.endpoint}/api/whoami-v2",
@@ -1345,15 +1405,18 @@ class HfApi:
             ) from e
         return r.json()
 
-    def get_token_permission(self, token: Optional[str] = None) -> Literal["read", "write", None]:
+    def get_token_permission(self, token: Union[bool, str, None] = None) -> Literal["read", "write", None]:
         """
         Check if a given `token` is valid and return its permissions.
 
         For more details about tokens, please refer to https://huggingface.co/docs/hub/security-tokens#what-are-user-access-tokens.
 
         Args:
-            token (`str`, *optional*):
-                The token to check for validity. Defaults to the one saved locally.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Returns:
             `Literal["read", "write", None]`: Permission granted by the token ("read" or "write"). Returns `None` if no
@@ -1402,7 +1465,7 @@ class HfApi:
         full: Optional[bool] = None,
         cardData: bool = False,
         fetch_config: bool = False,
-        token: Optional[Union[bool, str]] = None,
+        token: Union[bool, str, None] = None,
         pipeline_tag: Optional[str] = None,
     ) -> Iterable[ModelInfo]:
         """
@@ -1458,11 +1521,11 @@ class HfApi:
             fetch_config (`bool`, *optional*):
                 Whether to fetch the model configs as well. This is not included
                 in `full` due to its size.
-            token (`bool` or `str`, *optional*):
-                A valid authentication token (see https://huggingface.co/settings/token).
-                If `None` or `True` and machine is logged in (through `huggingface-cli login`
-                or [`~huggingface_hub.login`]), token will be retrieved from the cache.
-                If `False`, token is not sent in the request header.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
             pipeline_tag (`str`, *optional*):
                 A string pipeline tag to filter models on the Hub by, such as `summarization`
 
@@ -1642,7 +1705,7 @@ class HfApi:
         direction: Optional[Literal[-1]] = None,
         limit: Optional[int] = None,
         full: Optional[bool] = None,
-        token: Optional[str] = None,
+        token: Union[bool, str, None] = None,
     ) -> Iterable[DatasetInfo]:
         """
         List datasets hosted on the Huggingface Hub, given some filters.
@@ -1696,11 +1759,11 @@ class HfApi:
                 Whether to fetch all dataset data, including the `last_modified`,
                 the `card_data` and  the files. Can contain useful information such as the
                 PapersWithCode ID.
-            token (`bool` or `str`, *optional*):
-                A valid authentication token (see https://huggingface.co/settings/token).
-                If `None` or `True` and machine is logged in (through `huggingface-cli login`
-                or [`~huggingface_hub.login`]), token will be retrieved from the cache.
-                If `False`, token is not sent in the request header.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Returns:
             `Iterable[DatasetInfo]`: an iterable of [`huggingface_hub.hf_api.DatasetInfo`] objects.
@@ -1868,7 +1931,7 @@ class HfApi:
         models: Union[str, Iterable[str], None] = None,
         linked: bool = False,
         full: Optional[bool] = None,
-        token: Optional[str] = None,
+        token: Union[bool, str, None] = None,
     ) -> Iterable[SpaceInfo]:
         """
         List spaces hosted on the Huggingface Hub, given some filters.
@@ -1900,11 +1963,11 @@ class HfApi:
             full (`bool`, *optional*):
                 Whether to fetch all Spaces data, including the `last_modified`, `siblings`
                 and `card_data` fields.
-            token (`bool` or `str`, *optional*):
-                A valid authentication token (see https://huggingface.co/settings/token).
-                If `None` or `True` and machine is logged in (through `huggingface-cli login`
-                or [`~huggingface_hub.login`]), token will be retrieved from the cache.
-                If `False`, token is not sent in the request header.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Returns:
             `Iterable[SpaceInfo]`: an iterable of [`huggingface_hub.hf_api.SpaceInfo`] objects.
@@ -1946,7 +2009,7 @@ class HfApi:
         self,
         repo_id: str,
         *,
-        token: Optional[str] = None,
+        token: Union[bool, str, None] = None,
         repo_type: Optional[str] = None,
     ) -> None:
         """
@@ -1958,8 +2021,11 @@ class HfApi:
             repo_id (`str`):
                 The repository to like. Example: `"user/my-cool-model"`.
 
-            token (`str`, *optional*):
-                Authentication token. Will default to the stored token.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
             repo_type (`str`, *optional*):
                 Set to `"dataset"` or `"space"` if liking a dataset or space, `None` or
@@ -1994,7 +2060,7 @@ class HfApi:
         self,
         repo_id: str,
         *,
-        token: Optional[str] = None,
+        token: Union[bool, str, None] = None,
         repo_type: Optional[str] = None,
     ) -> None:
         """
@@ -2006,8 +2072,11 @@ class HfApi:
             repo_id (`str`):
                 The repository to unlike. Example: `"user/my-cool-model"`.
 
-            token (`str`, *optional*):
-                Authentication token. Will default to the stored token.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
             repo_type (`str`, *optional*):
                 Set to `"dataset"` or `"space"` if unliking a dataset or space, `None` or
@@ -2041,7 +2110,7 @@ class HfApi:
         self,
         user: Optional[str] = None,
         *,
-        token: Optional[str] = None,
+        token: Union[bool, str, None] = None,
     ) -> UserLikes:
         """
         List all public repos liked by a user on huggingface.co.
@@ -2054,10 +2123,11 @@ class HfApi:
         Args:
             user (`str`, *optional*):
                 Name of the user for which you want to fetch the likes.
-            token (`str`, *optional*):
-                A valid authentication token (see https://huggingface.co/settings/token).
-                Used only if `user` is not passed to implicitly determine the current
-                user name.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Returns:
             [`UserLikes`]: object containing the user name and 3 lists of repo ids (1 for
@@ -2117,7 +2187,7 @@ class HfApi:
         repo_id: str,
         *,
         repo_type: Optional[str] = None,
-        token: Optional[str] = None,
+        token: Union[bool, str, None] = None,
     ) -> List[User]:
         """
         List all users who liked a given repo on the hugging Face Hub.
@@ -2128,8 +2198,11 @@ class HfApi:
             repo_id (`str`):
                 The repository to retrieve . Example: `"user/my-cool-model"`.
 
-            token (`str`, *optional*):
-                Authentication token. Will default to the stored token.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
             repo_type (`str`, *optional*):
                 Set to `"dataset"` or `"space"` if uploading to a dataset or
@@ -2170,7 +2243,7 @@ class HfApi:
         timeout: Optional[float] = None,
         securityStatus: Optional[bool] = None,
         files_metadata: bool = False,
-        token: Optional[Union[bool, str]] = None,
+        token: Union[bool, str, None] = None,
     ) -> ModelInfo:
         """
         Get info on one specific model on huggingface.co
@@ -2192,11 +2265,11 @@ class HfApi:
             files_metadata (`bool`, *optional*):
                 Whether or not to retrieve metadata for files in the repository
                 (size, LFS metadata, etc). Defaults to `False`.
-            token (`bool` or `str`, *optional*):
-                A valid authentication token (see https://huggingface.co/settings/token).
-                If `None` or `True` and machine is logged in (through `huggingface-cli login`
-                or [`~huggingface_hub.login`]), token will be retrieved from the cache.
-                If `False`, token is not sent in the request header.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Returns:
             [`huggingface_hub.hf_api.ModelInfo`]: The model repository information.
@@ -2237,7 +2310,7 @@ class HfApi:
         revision: Optional[str] = None,
         timeout: Optional[float] = None,
         files_metadata: bool = False,
-        token: Optional[Union[bool, str]] = None,
+        token: Union[bool, str, None] = None,
     ) -> DatasetInfo:
         """
         Get info on one specific dataset on huggingface.co.
@@ -2256,11 +2329,11 @@ class HfApi:
             files_metadata (`bool`, *optional*):
                 Whether or not to retrieve metadata for files in the repository
                 (size, LFS metadata, etc). Defaults to `False`.
-            token (`bool` or `str`, *optional*):
-                A valid authentication token (see https://huggingface.co/settings/token).
-                If `None` or `True` and machine is logged in (through `huggingface-cli login`
-                or [`~huggingface_hub.login`]), token will be retrieved from the cache.
-                If `False`, token is not sent in the request header.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Returns:
             [`hf_api.DatasetInfo`]: The dataset repository information.
@@ -2300,7 +2373,7 @@ class HfApi:
         revision: Optional[str] = None,
         timeout: Optional[float] = None,
         files_metadata: bool = False,
-        token: Optional[Union[bool, str]] = None,
+        token: Union[bool, str, None] = None,
     ) -> SpaceInfo:
         """
         Get info on one specific Space on huggingface.co.
@@ -2319,11 +2392,11 @@ class HfApi:
             files_metadata (`bool`, *optional*):
                 Whether or not to retrieve metadata for files in the repository
                 (size, LFS metadata, etc). Defaults to `False`.
-            token (`bool` or `str`, *optional*):
-                A valid authentication token (see https://huggingface.co/settings/token).
-                If `None` or `True` and machine is logged in (through `huggingface-cli login`
-                or [`~huggingface_hub.login`]), token will be retrieved from the cache.
-                If `False`, token is not sent in the request header.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Returns:
             [`~hf_api.SpaceInfo`]: The space repository information.
@@ -2364,7 +2437,7 @@ class HfApi:
         repo_type: Optional[str] = None,
         timeout: Optional[float] = None,
         files_metadata: bool = False,
-        token: Optional[Union[bool, str]] = None,
+        token: Union[bool, str, None] = None,
     ) -> Union[ModelInfo, DatasetInfo, SpaceInfo]:
         """
         Get the info object for a given repo of a given type.
@@ -2384,11 +2457,11 @@ class HfApi:
             files_metadata (`bool`, *optional*):
                 Whether or not to retrieve metadata for files in the repository
                 (size, LFS metadata, etc). Defaults to `False`.
-            token (`bool` or `str`, *optional*):
-                A valid authentication token (see https://huggingface.co/settings/token).
-                If `None` or `True` and machine is logged in (through `huggingface-cli login`
-                or [`~huggingface_hub.login`]), token will be retrieved from the cache.
-                If `False`, token is not sent in the request header.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Returns:
             `Union[SpaceInfo, DatasetInfo, ModelInfo]`: The repository information, as a
@@ -2429,7 +2502,7 @@ class HfApi:
         repo_id: str,
         *,
         repo_type: Optional[str] = None,
-        token: Optional[str] = None,
+        token: Union[str, bool, None] = None,
     ) -> bool:
         """
         Checks if a repository exists on the Hugging Face Hub.
@@ -2441,11 +2514,11 @@ class HfApi:
             repo_type (`str`, *optional*):
                 Set to `"dataset"` or `"space"` if getting repository info from a dataset or a space,
                 `None` or `"model"` if getting repository info from a model. Default is `None`.
-            token (`bool` or `str`, *optional*):
-                A valid authentication token (see https://huggingface.co/settings/token).
-                If `None` or `True` and machine is logged in (through `huggingface-cli login`
-                or [`~huggingface_hub.login`]), token will be retrieved from the cache.
-                If `False`, token is not sent in the request header.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Returns:
             True if the repository exists, False otherwise.
@@ -2474,7 +2547,7 @@ class HfApi:
         revision: str,
         *,
         repo_type: Optional[str] = None,
-        token: Optional[str] = None,
+        token: Union[str, bool, None] = None,
     ) -> bool:
         """
         Checks if a specific revision exists on a repo on the Hugging Face Hub.
@@ -2488,11 +2561,11 @@ class HfApi:
             repo_type (`str`, *optional*):
                 Set to `"dataset"` or `"space"` if getting repository info from a dataset or a space,
                 `None` or `"model"` if getting repository info from a model. Default is `None`.
-            token (`bool` or `str`, *optional*):
-                A valid authentication token (see https://huggingface.co/settings/token).
-                If `None` or `True` and machine is logged in (through `huggingface-cli login`
-                or [`~huggingface_hub.login`]), token will be retrieved from the cache.
-                If `False`, token is not sent in the request header.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Returns:
             True if the repository and the revision exists, False otherwise.
@@ -2539,11 +2612,11 @@ class HfApi:
                 `None` or `"model"` if getting repository info from a model. Default is `None`.
             revision (`str`, *optional*):
                 The revision of the repository from which to get the information. Defaults to `"main"` branch.
-            token (`bool` or `str`, *optional*):
-                A valid authentication token (see https://huggingface.co/settings/token).
-                If `None` or `True` and machine is logged in (through `huggingface-cli login`
-                or [`~huggingface_hub.login`]), token will be retrieved from the cache.
-                If `False`, token is not sent in the request header.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Returns:
             True if the file exists, False otherwise.
@@ -2572,190 +2645,6 @@ class HfApi:
         except (RepositoryNotFoundError, EntryNotFoundError, RevisionNotFoundError):
             return False
 
-    @validate_hf_hub_args
-    @_deprecate_method(version="0.23", message="Use `list_repo_tree` and `get_paths_info` instead.")
-    def list_files_info(
-        self,
-        repo_id: str,
-        paths: Union[List[str], str, None] = None,
-        *,
-        expand: bool = False,
-        revision: Optional[str] = None,
-        repo_type: Optional[str] = None,
-        token: Optional[Union[bool, str]] = None,
-    ) -> Iterable[RepoFile]:
-        """
-        List files on a repo and get information about them.
-
-        Takes as input a list of paths. Those paths can be either files or folders. Two server endpoints are called:
-        1. POST "/paths-info" to get information about the provided paths. Called once.
-        2. GET  "/tree?recursive=True" to paginate over the input folders. Called only if a folder path is provided as
-           input. Will be called multiple times to follow pagination.
-        If no path is provided as input, step 1. is ignored and all files from the repo are listed.
-
-        Args:
-            repo_id (`str`):
-                A namespace (user or an organization) and a repo name separated by a `/`.
-            paths (`Union[List[str], str, None]`, *optional*):
-                The paths to get information about. Paths to files are directly resolved. Paths to folders are resolved
-                recursively which means that information is returned about all files in the folder and its subfolders.
-                If `None`, all files are returned (the default). If a path do not exist, it is ignored without raising
-                an exception.
-            expand (`bool`, *optional*, defaults to `False`):
-                Whether to fetch more information about the files (e.g. last commit and security scan results). This
-                operation is more expensive for the server so only 50 results are returned per page (instead of 1000).
-                As pagination is implemented in `huggingface_hub`, this is transparent for you except for the time it
-                takes to get the results.
-            revision (`str`, *optional*):
-                The revision of the repository from which to get the information. Defaults to `"main"` branch.
-            repo_type (`str`, *optional*):
-                The type of the repository from which to get the information (`"model"`, `"dataset"` or `"space"`.
-                Defaults to `"model"`.
-            token (`bool` or `str`, *optional*):
-                A valid authentication token (see https://huggingface.co/settings/token). If `None` or `True` and
-                machine is logged in (through `huggingface-cli login` or [`~huggingface_hub.login`]), token will be
-                retrieved from the cache. If `False`, token is not sent in the request header.
-
-        Returns:
-            `Iterable[RepoFile]`:
-                The information about the files, as an iterable of [`RepoFile`] objects. The order of the files is
-                not guaranteed.
-
-        Raises:
-            [`~utils.RepositoryNotFoundError`]:
-                If repository is not found (error 404): wrong repo_id/repo_type, private but not authenticated or repo
-                does not exist.
-            [`~utils.RevisionNotFoundError`]:
-                If revision is not found (error 404) on the repo.
-
-        Examples:
-
-            Get information about files on a repo.
-            ```py
-            >>> from huggingface_hub import list_files_info
-            >>> files_info = list_files_info("lysandre/arxiv-nlp", ["README.md", "config.json"])
-            >>> files_info
-            <generator object HfApi.list_files_info at 0x7f93b848e730>
-            >>> list(files_info)
-            [
-                RepoFile(path='README.md', size=391, blob_id='43bd404b159de6fba7c2f4d3264347668d43af25', lfs=None, last_commit=None, security=None),
-                RepoFile(path='config.json', size=554, blob_id='2f9618c3a19b9a61add74f70bfb121335aeef666', lfs=None, last_commit=None, security=None)
-            ]
-            ```
-
-            Get even more information about files on a repo (last commit and security scan results)
-            ```py
-            >>> from huggingface_hub import list_files_info
-            >>> files_info = list_files_info("prompthero/openjourney-v4", expand=True)
-            >>> list(files_info)
-            [
-                RepoFile(
-                    path='safety_checker/pytorch_model.bin',
-                    size=1216064769,
-                    blob_id='c8835557a0d3af583cb06c7c154b7e54a069c41d',
-                    lfs={
-                        'size': 1216064769,
-                        'sha256': '16d28f2b37109f222cdc33620fdd262102ac32112be0352a7f77e9614b35a394',
-                        'pointer_size': 135
-                    },
-                    last_commit={
-                        'oid': '47b62b20b20e06b9de610e840282b7e6c3d51190',
-                        'title': 'Upload diffusers weights (#48)',
-                        'date': datetime.datetime(2023, 3, 21, 10, 5, 27, tzinfo=datetime.timezone.utc)
-                    },
-                    security={
-                        'safe': True,
-                        'av_scan': {
-                            'virusFound': False,
-                            'virusNames': None
-                        },
-                        'pickle_import_scan': {
-                            'highestSafetyLevel': 'innocuous',
-                            'imports': [
-                                {'module': 'torch', 'name': 'FloatStorage', 'safety': 'innocuous'},
-                                {'module': 'collections', 'name': 'OrderedDict', 'safety': 'innocuous'},
-                                {'module': 'torch', 'name': 'LongStorage', 'safety': 'innocuous'},
-                                {'module': 'torch._utils', 'name': '_rebuild_tensor_v2', 'safety': 'innocuous'}
-                            ]
-                        }
-                    }
-                ),
-                RepoFile(
-                    path='scheduler/scheduler_config.json',
-                    size=465,
-                    blob_id='70d55e3e9679f41cbc66222831b38d5abce683dd',
-                    lfs=None,
-                    last_commit={
-                        'oid': '47b62b20b20e06b9de610e840282b7e6c3d51190',
-                        'title': 'Upload diffusers weights (#48)',
-                        'date': datetime.datetime(2023, 3, 21, 10, 5, 27, tzinfo=datetime.timezone.utc)},
-                        security={
-                            'safe': True,
-                            'av_scan': {
-                                'virusFound': False,
-                                'virusNames': None
-                            },
-                            'pickle_import_scan': None
-                        }
-                ),
-                ...
-            ]
-            ```
-
-            List LFS files from the "vae/" folder in "stabilityai/stable-diffusion-2" repository.
-
-            ```py
-            >>> from huggingface_hub import list_files_info
-            >>> [info.path for info in list_files_info("stabilityai/stable-diffusion-2", "vae") if info.lfs is not None]
-            ['vae/diffusion_pytorch_model.bin', 'vae/diffusion_pytorch_model.safetensors']
-            ```
-
-            List all files on a repo.
-            ```py
-            >>> from huggingface_hub import list_files_info
-            >>> [info.path for info in list_files_info("glue", repo_type="dataset")]
-            ['.gitattributes', 'README.md', 'dataset_infos.json', 'glue.py']
-            ```
-        """
-        repo_type = repo_type or REPO_TYPE_MODEL
-        revision = quote(revision, safe="") if revision is not None else DEFAULT_REVISION
-        headers = self._build_hf_headers(token=token)
-
-        folder_paths = []
-        if paths is None:
-            # `paths` is not provided => list all files from the repo
-            folder_paths.append("")
-        elif paths == []:
-            # corner case: server would return a 400 error if `paths` is an empty list. Let's return early.
-            return
-        else:
-            # `paths` is provided => get info about those
-            response = get_session().post(
-                f"{self.endpoint}/api/{repo_type}s/{repo_id}/paths-info/{revision}",
-                data={
-                    "paths": paths if isinstance(paths, list) else [paths],
-                    "expand": expand,
-                },
-                headers=headers,
-            )
-            hf_raise_for_status(response)
-            paths_info = response.json()
-
-            # List top-level files first
-            for path_info in paths_info:
-                if path_info["type"] == "file":
-                    yield RepoFile(**path_info)
-                else:
-                    folder_paths.append(path_info["path"])
-
-        # List files in subdirectories
-        for path in folder_paths:
-            encoded_path = "/" + quote(path, safe="") if path else ""
-            tree_url = f"{self.endpoint}/api/{repo_type}s/{repo_id}/tree/{revision}{encoded_path}"
-            for subpath_info in paginate(path=tree_url, headers=headers, params={"recursive": True, "expand": expand}):
-                if subpath_info["type"] == "file":
-                    yield RepoFile(**subpath_info)
-
     @validate_hf_hub_args
     def list_repo_files(
         self,
@@ -2763,7 +2652,7 @@ class HfApi:
         *,
         revision: Optional[str] = None,
         repo_type: Optional[str] = None,
-        token: Optional[Union[bool, str]] = None,
+        token: Union[str, bool, None] = None,
     ) -> List[str]:
         """
         Get the list of files in a given repo.
@@ -2776,10 +2665,11 @@ class HfApi:
             repo_type (`str`, *optional*):
                 Set to `"dataset"` or `"space"` if uploading to a dataset or space, `None` or `"model"` if uploading to
                 a model. Default is `None`.
-            token (`bool` or `str`, *optional*):
-                A valid authentication token (see https://huggingface.co/settings/token). If `None` or `True` and
-                machine is logged in (through `huggingface-cli login` or [`~huggingface_hub.login`]), token will be
-                retrieved from the cache. If `False`, token is not sent in the request header.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Returns:
             `List[str]`: the list of files in a given repository.
@@ -2802,7 +2692,7 @@ class HfApi:
         expand: bool = False,
         revision: Optional[str] = None,
         repo_type: Optional[str] = None,
-        token: Optional[Union[bool, str]] = None,
+        token: Union[str, bool, None] = None,
     ) -> Iterable[Union[RepoFile, RepoFolder]]:
         """
         List a repo tree's files and folders and get information about them.
@@ -2825,10 +2715,11 @@ class HfApi:
             repo_type (`str`, *optional*):
                 The type of the repository from which to get the tree (`"model"`, `"dataset"` or `"space"`.
                 Defaults to `"model"`.
-            token (`bool` or `str`, *optional*):
-                A valid authentication token (see https://huggingface.co/settings/token). If `None` or `True` and
-                machine is logged in (through `huggingface-cli login` or [`~huggingface_hub.login`]), token will be
-                retrieved from the cache. If `False`, token is not sent in the request header.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Returns:
             `Iterable[Union[RepoFile, RepoFolder]]`:
@@ -2930,7 +2821,7 @@ class HfApi:
         *,
         repo_type: Optional[str] = None,
         include_pull_requests: bool = False,
-        token: Optional[Union[bool, str]] = None,
+        token: Union[str, bool, None] = None,
     ) -> GitRefs:
         """
         Get the list of refs of a given repo (both tags and branches).
@@ -2944,11 +2835,11 @@ class HfApi:
                 `None` or `"model"` if listing from a model. Default is `None`.
             include_pull_requests (`bool`, *optional*):
                 Whether to include refs from pull requests in the list. Defaults to `False`.
-            token (`bool` or `str`, *optional*):
-                A valid authentication token (see https://huggingface.co/settings/token).
-                If `None` or `True` and machine is logged in (through `huggingface-cli login`
-                or [`~huggingface_hub.login`]), token will be retrieved from the cache.
-                If `False`, token is not sent in the request header.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Example:
         ```py
@@ -3001,7 +2892,7 @@ class HfApi:
         repo_id: str,
         *,
         repo_type: Optional[str] = None,
-        token: Optional[Union[bool, str]] = None,
+        token: Union[bool, str, None] = None,
         revision: Optional[str] = None,
         formatted: bool = False,
     ) -> List[GitCommitInfo]:
@@ -3016,11 +2907,11 @@ class HfApi:
             repo_type (`str`, *optional*):
                 Set to `"dataset"` or `"space"` if listing commits from a dataset or a Space, `None` or `"model"` if
                 listing from a model. Default is `None`.
-            token (`bool` or `str`, *optional*):
-                A valid authentication token (see https://huggingface.co/settings/token).
-                If `None` or `True` and machine is logged in (through `huggingface-cli login`
-                or [`~huggingface_hub.login`]), token will be retrieved from the cache.
-                If `False`, token is not sent in the request header.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
             revision (`str`, *optional*):
                 The git revision to commit from. Defaults to the head of the `"main"` branch.
             formatted (`bool`):
@@ -3090,7 +2981,7 @@ class HfApi:
         expand: bool = False,
         revision: Optional[str] = None,
         repo_type: Optional[str] = None,
-        token: Optional[Union[bool, str]] = None,
+        token: Union[str, bool, None] = None,
     ) -> List[Union[RepoFile, RepoFolder]]:
         """
         Get information about a repo's paths.
@@ -3111,10 +3002,11 @@ class HfApi:
             repo_type (`str`, *optional*):
                 The type of the repository from which to get the information (`"model"`, `"dataset"` or `"space"`.
                 Defaults to `"model"`.
-            token (`bool` or `str`, *optional*):
-                A valid authentication token (see https://huggingface.co/settings/token). If `None` or `True` and
-                machine is logged in (through `huggingface-cli login` or [`~huggingface_hub.login`]), token will be
-                retrieved from the cache. If `False`, token is not sent in the request header.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Returns:
             `List[Union[RepoFile, RepoFolder]]`:
@@ -3165,7 +3057,7 @@ class HfApi:
         branch: Optional[str] = None,
         commit_message: Optional[str] = None,
         repo_type: Optional[str] = None,
-        token: Optional[str] = None,
+        token: Union[str, bool, None] = None,
     ) -> None:
         """Squash commit history on a branch for a repo on the Hub.
 
@@ -3195,10 +3087,11 @@ class HfApi:
             repo_type (`str`, *optional*):
                 Set to `"dataset"` or `"space"` if listing commits from a dataset or a Space, `None` or `"model"` if
                 listing from a model. Default is `None`.
-            token (`str`, *optional*):
-                A valid authentication token (see https://huggingface.co/settings/token). If the machine is logged in
-                (through `huggingface-cli login` or [`~huggingface_hub.login`]), token can be automatically retrieved
-                from the cache.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Raises:
             [`~utils.RepositoryNotFoundError`]:
@@ -3247,7 +3140,7 @@ class HfApi:
         self,
         repo_id: str,
         *,
-        token: Optional[str] = None,
+        token: Union[str, bool, None] = None,
         private: bool = False,
         repo_type: Optional[str] = None,
         exist_ok: bool = False,
@@ -3264,8 +3157,11 @@ class HfApi:
             repo_id (`str`):
                 A namespace (user or an organization) and a repo name separated
                 by a `/`.
-            token (`str`, *optional*):
-                An authentication token (See https://huggingface.co/settings/token)
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
             private (`bool`, *optional*, defaults to `False`):
                 Whether the model repo should be private.
             repo_type (`str`, *optional*):
@@ -3370,7 +3266,7 @@ class HfApi:
                         return RepoUrl(f"{self.endpoint}/{repo_id}")
                     return RepoUrl(f"{self.endpoint}/{repo_type}/{repo_id}")
                 except HfHubHTTPError:
-                    raise
+                    raise err
             else:
                 raise
 
@@ -3382,7 +3278,7 @@ class HfApi:
         self,
         repo_id: str,
         *,
-        token: Optional[str] = None,
+        token: Union[str, bool, None] = None,
         repo_type: Optional[str] = None,
         missing_ok: bool = False,
     ) -> None:
@@ -3393,8 +3289,11 @@ class HfApi:
             repo_id (`str`):
                 A namespace (user or an organization) and a repo name separated
                 by a `/`.
-            token (`str`, *optional*):
-                An authentication token (See https://huggingface.co/settings/token)
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
             repo_type (`str`, *optional*):
                 Set to `"dataset"` or `"space"` if uploading to a dataset or
                 space, `None` or `"model"` if uploading to a model.
@@ -3433,7 +3332,7 @@ class HfApi:
         repo_id: str,
         private: bool = False,
         *,
-        token: Optional[str] = None,
+        token: Union[str, bool, None] = None,
         organization: Optional[str] = None,
         repo_type: Optional[str] = None,
         name: Optional[str] = None,
@@ -3446,8 +3345,11 @@ class HfApi:
                 by a `/`.
             private (`bool`, *optional*, defaults to `False`):
                 Whether the model repo should be private.
-            token (`str`, *optional*):
-                An authentication token (See https://huggingface.co/settings/token)
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
             repo_type (`str`, *optional*):
                 Set to `"dataset"` or `"space"` if uploading to a dataset or
                 space, `None` or `"model"` if uploading to a model. Default is
@@ -3493,7 +3395,7 @@ class HfApi:
         to_id: str,
         *,
         repo_type: Optional[str] = None,
-        token: Optional[str] = None,
+        token: Union[str, bool, None] = None,
     ):
         """
         Moving a repository from namespace1/repo_name1 to namespace2/repo_name2
@@ -3513,8 +3415,11 @@ class HfApi:
                 Set to `"dataset"` or `"space"` if uploading to a dataset or
                 space, `None` or `"model"` if uploading to a model. Default is
                 `None`.
-            token (`str`, *optional*):
-                An authentication token (See https://huggingface.co/settings/token)
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         <Tip>
 
@@ -3557,7 +3462,7 @@ class HfApi:
         *,
         commit_message: str,
         commit_description: Optional[str] = None,
-        token: Optional[str] = None,
+        token: Union[str, bool, None] = None,
         repo_type: Optional[str] = None,
         revision: Optional[str] = None,
         create_pr: Optional[bool] = None,
@@ -3574,7 +3479,7 @@ class HfApi:
         *,
         commit_message: str,
         commit_description: Optional[str] = None,
-        token: Optional[str] = None,
+        token: Union[str, bool, None] = None,
         repo_type: Optional[str] = None,
         revision: Optional[str] = None,
         create_pr: Optional[bool] = None,
@@ -3592,7 +3497,7 @@ class HfApi:
         *,
         commit_message: str,
         commit_description: Optional[str] = None,
-        token: Optional[str] = None,
+        token: Union[str, bool, None] = None,
         repo_type: Optional[str] = None,
         revision: Optional[str] = None,
         create_pr: Optional[bool] = None,
@@ -3646,9 +3551,11 @@ class HfApi:
             commit_description (`str`, *optional*):
                 The description of the commit that will be created
 
-            token (`str`, *optional*):
-                Authentication token, obtained with `HfApi.login` method. Will
-                default to the stored token.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
             repo_type (`str`, *optional*):
                 Set to `"dataset"` or `"space"` if uploading to a dataset or
@@ -3844,7 +3751,7 @@ class HfApi:
         deletion_commits: List[List[CommitOperationDelete]],
         commit_message: str,
         commit_description: Optional[str] = None,
-        token: Optional[str] = None,
+        token: Union[str, bool, None] = None,
         repo_type: Optional[str] = None,
         merge_pr: bool = True,
         num_threads: int = 5,  # TODO: use to multithread uploads
@@ -3892,8 +3799,11 @@ class HfApi:
             commit_description (`str`, *optional*):
                 The description of the commit that will be created. The description will be added to the PR.
 
-            token (`str`, *optional*):
-                Authentication token, obtained with `HfApi.login` method. Will default to the stored token.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
             repo_type (`str`, *optional*):
                 Set to `"dataset"` or `"space"` if uploading to a dataset or space, `None` or `"model"` if uploading to
@@ -4139,7 +4049,7 @@ class HfApi:
         repo_id: str,
         additions: Iterable[CommitOperationAdd],
         *,
-        token: Optional[str] = None,
+        token: Union[str, bool, None] = None,
         repo_type: Optional[str] = None,
         revision: Optional[str] = None,
         create_pr: Optional[bool] = None,
@@ -4176,8 +4086,11 @@ class HfApi:
                 The list of files to upload. Warning: the objects in this list will be mutated to include information
                 relative to the upload. Do not reuse the same objects for multiple commits.
 
-            token (`str`, *optional*):
-                Authentication token. Will default to the stored token.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
             repo_type (`str`, *optional*):
                 The type of repository to upload to (e.g. `"model"` -default-, `"dataset"` or `"space"`).
@@ -4292,7 +4205,7 @@ class HfApi:
         path_or_fileobj: Union[str, Path, bytes, BinaryIO],
         path_in_repo: str,
         repo_id: str,
-        token: Optional[str] = None,
+        token: Union[str, bool, None] = None,
         repo_type: Optional[str] = None,
         revision: Optional[str] = None,
         commit_message: Optional[str] = None,
@@ -4309,7 +4222,7 @@ class HfApi:
         path_or_fileobj: Union[str, Path, bytes, BinaryIO],
         path_in_repo: str,
         repo_id: str,
-        token: Optional[str] = None,
+        token: Union[str, bool, None] = None,
         repo_type: Optional[str] = None,
         revision: Optional[str] = None,
         commit_message: Optional[str] = None,
@@ -4327,7 +4240,7 @@ class HfApi:
         path_or_fileobj: Union[str, Path, bytes, BinaryIO],
         path_in_repo: str,
         repo_id: str,
-        token: Optional[str] = None,
+        token: Union[str, bool, None] = None,
         repo_type: Optional[str] = None,
         revision: Optional[str] = None,
         commit_message: Optional[str] = None,
@@ -4351,9 +4264,11 @@ class HfApi:
             repo_id (`str`):
                 The repository to which the file will be uploaded, for example:
                 `"username/custom_transformers"`
-            token (`str`, *optional*):
-                Authentication token, obtained with `HfApi.login` method. Will
-                default to the stored token.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
             repo_type (`str`, *optional*):
                 Set to `"dataset"` or `"space"` if uploading to a dataset or
                 space, `None` or `"model"` if uploading to a model. Default is
@@ -4494,7 +4409,7 @@ class HfApi:
         path_in_repo: Optional[str] = None,
         commit_message: Optional[str] = None,
         commit_description: Optional[str] = None,
-        token: Optional[str] = None,
+        token: Union[str, bool, None] = None,
         repo_type: Optional[str] = None,
         revision: Optional[str] = None,
         create_pr: Optional[bool] = None,
@@ -4516,7 +4431,7 @@ class HfApi:
         path_in_repo: Optional[str] = None,
         commit_message: Optional[str] = None,
         commit_description: Optional[str] = None,
-        token: Optional[str] = None,
+        token: Union[str, bool, None] = None,
         repo_type: Optional[str] = None,
         revision: Optional[str] = None,
         create_pr: Optional[bool] = None,
@@ -4539,7 +4454,7 @@ class HfApi:
         path_in_repo: Optional[str] = None,
         commit_message: Optional[str] = None,
         commit_description: Optional[str] = None,
-        token: Optional[str] = None,
+        token: Union[str, bool, None] = None,
         repo_type: Optional[str] = None,
         revision: Optional[str] = None,
         create_pr: Optional[bool] = None,
@@ -4561,7 +4476,7 @@ class HfApi:
         path_in_repo: Optional[str] = None,
         commit_message: Optional[str] = None,
         commit_description: Optional[str] = None,
-        token: Optional[str] = None,
+        token: Union[str, bool, None] = None,
         repo_type: Optional[str] = None,
         revision: Optional[str] = None,
         create_pr: Optional[bool] = None,
@@ -4585,7 +4500,7 @@ class HfApi:
         path_in_repo: Optional[str] = None,
         commit_message: Optional[str] = None,
         commit_description: Optional[str] = None,
-        token: Optional[str] = None,
+        token: Union[str, bool, None] = None,
         repo_type: Optional[str] = None,
         revision: Optional[str] = None,
         create_pr: Optional[bool] = None,
@@ -4629,9 +4544,11 @@ class HfApi:
             path_in_repo (`str`, *optional*):
                 Relative path of the directory in the repo, for example:
                 `"checkpoints/1fec34a/results"`. Will default to the root folder of the repository.
-            token (`str`, *optional*):
-                Authentication token, obtained with `HfApi.login` method. Will
-                default to the stored token.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
             repo_type (`str`, *optional*):
                 Set to `"dataset"` or `"space"` if uploading to a dataset or
                 space, `None` or `"model"` if uploading to a model. Default is
@@ -4761,7 +4678,7 @@ class HfApi:
             ignore_patterns = []
         elif isinstance(ignore_patterns, str):
             ignore_patterns = [ignore_patterns]
-        ignore_patterns += IGNORE_GIT_FOLDER_PATTERNS
+        ignore_patterns += DEFAULT_IGNORE_PATTERNS
 
         delete_operations = self._prepare_upload_folder_deletions(
             repo_id=repo_id,
@@ -4840,7 +4757,7 @@ class HfApi:
         path_in_repo: str,
         repo_id: str,
         *,
-        token: Optional[str] = None,
+        token: Union[str, bool, None] = None,
         repo_type: Optional[str] = None,
         revision: Optional[str] = None,
         commit_message: Optional[str] = None,
@@ -4858,9 +4775,11 @@ class HfApi:
             repo_id (`str`):
                 The repository from which the file will be deleted, for example:
                 `"username/custom_transformers"`
-            token (`str`, *optional*):
-                Authentication token, obtained with `HfApi.login` method. Will
-                default to the stored token.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
             repo_type (`str`, *optional*):
                 Set to `"dataset"` or `"space"` if the file is in a dataset or
                 space, `None` or `"model"` if in a model. Default is `None`.
@@ -4928,7 +4847,7 @@ class HfApi:
         path_in_repo: str,
         repo_id: str,
         *,
-        token: Optional[str] = None,
+        token: Union[bool, str, None] = None,
         repo_type: Optional[str] = None,
         revision: Optional[str] = None,
         commit_message: Optional[str] = None,
@@ -4947,8 +4866,11 @@ class HfApi:
             repo_id (`str`):
                 The repository from which the folder will be deleted, for example:
                 `"username/custom_transformers"`
-            token (`str`, *optional*):
-                Authentication token, obtained with `HfApi.login` method. Will default
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
                 to the stored token.
             repo_type (`str`, *optional*):
                 Set to `"dataset"` or `"space"` if the folder is in a dataset or
@@ -5001,12 +4923,11 @@ class HfApi:
         Args:
             url (`str`):
                 File url, for example returned by [`hf_hub_url`].
-            token (`str` or `bool`, *optional*):
-                A token to be used for the download.
-                    - If `True`, the token is read from the HuggingFace config
-                    folder.
-                    - If `False` or `None`, no token is provided.
-                    - If a string, it's used as the authentication token.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
             proxies (`dict`, *optional*):
                 Dictionary mapping protocol to the URL of the proxy passed to `requests.request`.
             timeout (`float`, *optional*, defaults to 10):
@@ -5040,15 +4961,16 @@ class HfApi:
         revision: Optional[str] = None,
         cache_dir: Union[str, Path, None] = None,
         local_dir: Union[str, Path, None] = None,
-        local_dir_use_symlinks: Union[bool, Literal["auto"]] = "auto",
         force_download: bool = False,
-        force_filename: Optional[str] = None,
         proxies: Optional[Dict] = None,
         etag_timeout: float = DEFAULT_ETAG_TIMEOUT,
-        resume_download: bool = False,
-        token: Optional[Union[str, bool]] = None,
+        token: Union[bool, str, None] = None,
         local_files_only: bool = False,
+        # Deprecated args
+        resume_download: Optional[bool] = None,
         legacy_cache_layout: bool = False,
+        force_filename: Optional[str] = None,
+        local_dir_use_symlinks: Union[bool, Literal["auto"]] = "auto",
     ) -> str:
         """Download a given file if it's not already present in the local cache.
 
@@ -5062,21 +4984,6 @@ class HfApi:
             that have been resolved at that particular commit. Each filename is a symlink to the blob
             at that particular commit.
 
-        If `local_dir` is provided, the file structure from the repo will be replicated in this location. You can configure
-        how you want to move those files:
-        - If `local_dir_use_symlinks="auto"` (default), files are downloaded and stored in the cache directory as blob
-            files. Small files (<5MB) are duplicated in `local_dir` while a symlink is created for bigger files. The goal
-            is to be able to manually edit and save small files without corrupting the cache while saving disk space for
-            binary files. The 5MB threshold can be configured with the `HF_HUB_LOCAL_DIR_AUTO_SYMLINK_THRESHOLD`
-            environment variable.
-        - If `local_dir_use_symlinks=True`, files are downloaded, stored in the cache directory and symlinked in `local_dir`.
-            This is optimal in term of disk usage but files must not be manually edited.
-        - If `local_dir_use_symlinks=False` and the blob files exist in the cache directory, they are duplicated in the
-            local dir. This means disk usage is not optimized.
-        - Finally, if `local_dir_use_symlinks=False` and the blob files do not exist in the cache directory, then the
-            files are downloaded and directly placed under `local_dir`. This means if you need to download them again later,
-            they will be re-downloaded entirely.
-
         ```
         [  96]  .
         └── [ 160]  models--julien-c--EsperBERTo-small
@@ -5095,6 +5002,11 @@ class HfApi:
                     └── [  76]  pytorch_model.bin -> ../../blobs/403450e234d65943a7dcf7e05a771ce3c92faa84dd07db4ac20f592037a1e4bd
         ```
 
+        If `local_dir` is provided, the file structure from the repo will be replicated in this location. When using this
+        option, the `cache_dir` will not be used and a `.huggingface/` folder will be created at the root of `local_dir`
+        to store some metadata related to the downloaded files. While this mechanism is not as robust as the main
+        cache-system, it's optimized for regularly pulling the latest version of a repository.
+
         Args:
             repo_id (`str`):
                 A user or an organization name and a repo name separated by a `/`.
@@ -5111,13 +5023,7 @@ class HfApi:
             cache_dir (`str`, `Path`, *optional*):
                 Path to the folder where cached files are stored.
             local_dir (`str` or `Path`, *optional*):
-                If provided, the downloaded file will be placed under this directory, either as a symlink (default) or
-                a regular file (see description for more details).
-            local_dir_use_symlinks (`"auto"` or `bool`, defaults to `"auto"`):
-                To be used with `local_dir`. If set to "auto", the cache directory will be used and the file will be either
-                duplicated or symlinked to the local directory depending on its size. It set to `True`, a symlink will be
-                created, no matter the file size. If set to `False`, the file will either be duplicated from cache (if
-                already exists) or downloaded from the Hub and not cached. See description for more details.
+                If provided, the downloaded file will be placed under this directory.
             force_download (`bool`, *optional*, defaults to `False`):
                 Whether the file should be downloaded even if it already exists in
                 the local cache.
@@ -5127,29 +5033,19 @@ class HfApi:
             etag_timeout (`float`, *optional*, defaults to `10`):
                 When fetching ETag, how many seconds to wait for the server to send
                 data before giving up which is passed to `requests.request`.
-            resume_download (`bool`, *optional*, defaults to `False`):
-                If `True`, resume a previously interrupted download.
-            token (`bool` or `str`, *optional*):
-                A valid authentication token (see https://huggingface.co/settings/token).
-                If `None` or `True` and machine is logged in (through `huggingface-cli login`
-                or [`~huggingface_hub.login`]), token will be retrieved from the cache.
-                If `False`, token is not sent in the request header.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
             local_files_only (`bool`, *optional*, defaults to `False`):
                 If `True`, avoid downloading the file and return the path to the
                 local cached file if it exists.
-            legacy_cache_layout (`bool`, *optional*, defaults to `False`):
-                If `True`, uses the legacy file cache layout i.e. just call [`hf_hub_url`]
-                then `cached_download`. This is deprecated as the new cache layout is
-                more powerful.
 
         Returns:
-            Local path (string) of file or if networking is off, last version of
-            file cached on disk.
-
-        <Tip>
-
-        Raises the following errors:
+            `str`: Local path of file or if networking is off, last version of file cached on disk.
 
+        Raises:
             - [`EnvironmentError`](https://docs.python.org/3/library/exceptions.html#EnvironmentError)
             if `token=True` and the token cannot be found.
             - [`OSError`](https://docs.python.org/3/library/exceptions.html#OSError)
@@ -5165,8 +5061,6 @@ class HfApi:
             If the file to download cannot be found.
             - [`~utils.LocalEntryNotFoundError`]
             If network is disabled or unavailable and file is not found in cache.
-
-        </Tip>
         """
         from .file_download import hf_hub_download
 
@@ -5207,17 +5101,18 @@ class HfApi:
         revision: Optional[str] = None,
         cache_dir: Union[str, Path, None] = None,
         local_dir: Union[str, Path, None] = None,
-        local_dir_use_symlinks: Union[bool, Literal["auto"]] = "auto",
         proxies: Optional[Dict] = None,
         etag_timeout: float = DEFAULT_ETAG_TIMEOUT,
-        resume_download: bool = False,
         force_download: bool = False,
-        token: Optional[Union[str, bool]] = None,
+        token: Union[bool, str, None] = None,
         local_files_only: bool = False,
         allow_patterns: Optional[Union[List[str], str]] = None,
         ignore_patterns: Optional[Union[List[str], str]] = None,
         max_workers: int = 8,
         tqdm_class: Optional[base_tqdm] = None,
+        # Deprecated args
+        local_dir_use_symlinks: Union[bool, Literal["auto"]] = "auto",
+        resume_download: Optional[bool] = None,
     ) -> str:
         """Download repo files.
 
@@ -5226,20 +5121,10 @@ class HfApi:
         to keep their actual filename relative to that folder. You can also filter which files to download using
         `allow_patterns` and `ignore_patterns`.
 
-        If `local_dir` is provided, the file structure from the repo will be replicated in this location. You can configure
-        how you want to move those files:
-        - If `local_dir_use_symlinks="auto"` (default), files are downloaded and stored in the cache directory as blob
-            files. Small files (<5MB) are duplicated in `local_dir` while a symlink is created for bigger files. The goal
-            is to be able to manually edit and save small files without corrupting the cache while saving disk space for
-            binary files. The 5MB threshold can be configured with the `HF_HUB_LOCAL_DIR_AUTO_SYMLINK_THRESHOLD`
-            environment variable.
-        - If `local_dir_use_symlinks=True`, files are downloaded, stored in the cache directory and symlinked in `local_dir`.
-            This is optimal in term of disk usage but files must not be manually edited.
-        - If `local_dir_use_symlinks=False` and the blob files exist in the cache directory, they are duplicated in the
-            local dir. This means disk usage is not optimized.
-        - Finally, if `local_dir_use_symlinks=False` and the blob files do not exist in the cache directory, then the
-            files are downloaded and directly placed under `local_dir`. This means if you need to download them again later,
-            they will be re-downloaded entirely.
+        If `local_dir` is provided, the file structure from the repo will be replicated in this location. When using this
+        option, the `cache_dir` will not be used and a `.huggingface/` folder will be created at the root of `local_dir`
+        to store some metadata related to the downloaded files.While this mechanism is not as robust as the main
+        cache-system, it's optimized for regularly pulling the latest version of a repository.
 
         An alternative would be to clone the repo but this requires git and git-lfs to be installed and properly
         configured. It is also not possible to filter which files to download when cloning a repository using git.
@@ -5256,28 +5141,20 @@ class HfApi:
             cache_dir (`str`, `Path`, *optional*):
                 Path to the folder where cached files are stored.
             local_dir (`str` or `Path`, *optional*):
-                If provided, the downloaded files will be placed under this directory, either as symlinks (default) or
-                regular files (see description for more details).
-            local_dir_use_symlinks (`"auto"` or `bool`, defaults to `"auto"`):
-                To be used with `local_dir`. If set to "auto", the cache directory will be used and the file will be either
-                duplicated or symlinked to the local directory depending on its size. It set to `True`, a symlink will be
-                created, no matter the file size. If set to `False`, the file will either be duplicated from cache (if
-                already exists) or downloaded from the Hub and not cached. See description for more details.
+                If provided, the downloaded files will be placed under this directory.
             proxies (`dict`, *optional*):
                 Dictionary mapping protocol to the URL of the proxy passed to
                 `requests.request`.
             etag_timeout (`float`, *optional*, defaults to `10`):
                 When fetching ETag, how many seconds to wait for the server to send
                 data before giving up which is passed to `requests.request`.
-            resume_download (`bool`, *optional*, defaults to `False):
-                If `True`, resume a previously interrupted download.
             force_download (`bool`, *optional*, defaults to `False`):
                 Whether the file should be downloaded even if it already exists in the local cache.
-            token (`bool` or `str`, *optional*):
-                A valid authentication token (see https://huggingface.co/settings/token).
-                If `None` or `True` and machine is logged in (through `huggingface-cli login`
-                or [`~huggingface_hub.login`]), token will be retrieved from the cache.
-                If `False`, token is not sent in the request header.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
             local_files_only (`bool`, *optional*, defaults to `False`):
                 If `True`, avoid downloading the file and return the path to the
                 local cached file if it exists.
@@ -5296,20 +5173,15 @@ class HfApi:
                 `HF_HUB_DISABLE_PROGRESS_BARS` environment variable.
 
         Returns:
-            Local folder path (string) of repo snapshot
-
-        <Tip>
+            `str`: folder path of the repo snapshot.
 
-        Raises the following errors:
-
-        - [`EnvironmentError`](https://docs.python.org/3/library/exceptions.html#EnvironmentError)
-        if `token=True` and the token cannot be found.
-        - [`OSError`](https://docs.python.org/3/library/exceptions.html#OSError) if
-        ETag cannot be determined.
-        - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
-        if some parameter value is invalid
-
-        </Tip>
+        Raises:
+            - [`EnvironmentError`](https://docs.python.org/3/library/exceptions.html#EnvironmentError)
+            if `token=True` and the token cannot be found.
+            - [`OSError`](https://docs.python.org/3/library/exceptions.html#OSError) if
+            ETag cannot be determined.
+            - [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
+            if some parameter value is invalid
         """
         from ._snapshot_download import snapshot_download
 
@@ -5346,7 +5218,7 @@ class HfApi:
         *,
         repo_type: Optional[str] = None,
         revision: Optional[str] = None,
-        token: Optional[str] = None,
+        token: Union[bool, str, None] = None,
     ) -> SafetensorsRepoMetadata:
         """
         Parse metadata for a safetensors repo on the Hub.
@@ -5370,10 +5242,11 @@ class HfApi:
             revision (`str`, *optional*):
                 The git revision to fetch the file from. Can be a branch name, a tag, or a commit hash. Defaults to the
                 head of the `"main"` branch.
-            token (`bool` or `str`, *optional*):
-                A valid authentication token (see https://huggingface.co/settings/token). If `None` or `True` and
-                machine is logged in (through `huggingface-cli login` or [`~huggingface_hub.login`]), token will be
-                retrieved from the cache. If `False`, token is not sent in the request header.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Returns:
             [`SafetensorsRepoMetadata`]: information related to safetensors repo.
@@ -5468,7 +5341,7 @@ class HfApi:
         *,
         repo_type: Optional[str] = None,
         revision: Optional[str] = None,
-        token: Optional[str] = None,
+        token: Union[bool, str, None] = None,
     ) -> SafetensorsFileMetadata:
         """
         Parse metadata from a safetensors file on the Hub.
@@ -5488,10 +5361,11 @@ class HfApi:
             revision (`str`, *optional*):
                 The git revision to fetch the file from. Can be a branch name, a tag, or a commit hash. Defaults to the
                 head of the `"main"` branch.
-            token (`bool` or `str`, *optional*):
-                A valid authentication token (see https://huggingface.co/settings/token). If `None` or `True` and
-                machine is logged in (through `huggingface-cli login` or [`~huggingface_hub.login`]), token will be
-                retrieved from the cache. If `False`, token is not sent in the request header.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Returns:
             [`SafetensorsFileMetadata`]: information related to a safetensors file.
@@ -5568,7 +5442,7 @@ class HfApi:
         *,
         branch: str,
         revision: Optional[str] = None,
-        token: Optional[str] = None,
+        token: Union[bool, str, None] = None,
         repo_type: Optional[str] = None,
         exist_ok: bool = False,
     ) -> None:
@@ -5589,8 +5463,11 @@ class HfApi:
                 the OID/SHA of a commit, as a hexadecimal string. Defaults to the head
                 of the `"main"` branch.
 
-            token (`str`, *optional*):
-                Authentication token. Will default to the stored token.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
             repo_type (`str`, *optional*):
                 Set to `"dataset"` or `"space"` if creating a branch on a dataset or
@@ -5634,7 +5511,7 @@ class HfApi:
         repo_id: str,
         *,
         branch: str,
-        token: Optional[str] = None,
+        token: Union[bool, str, None] = None,
         repo_type: Optional[str] = None,
     ) -> None:
         """
@@ -5648,8 +5525,11 @@ class HfApi:
             branch (`str`):
                 The name of the branch to delete.
 
-            token (`str`, *optional*):
-                Authentication token. Will default to the stored token.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
             repo_type (`str`, *optional*):
                 Set to `"dataset"` or `"space"` if creating a branch on a dataset or
@@ -5685,7 +5565,7 @@ class HfApi:
         tag: str,
         tag_message: Optional[str] = None,
         revision: Optional[str] = None,
-        token: Optional[str] = None,
+        token: Union[bool, str, None] = None,
         repo_type: Optional[str] = None,
         exist_ok: bool = False,
     ) -> None:
@@ -5708,8 +5588,11 @@ class HfApi:
                 commit, as a hexadecimal string. Shorthands (7 first characters) are
                 also supported. Defaults to the head of the `"main"` branch.
 
-            token (`str`, *optional*):
-                Authentication token. Will default to the stored token.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
             repo_type (`str`, *optional*):
                 Set to `"dataset"` or `"space"` if tagging a dataset or
@@ -5754,7 +5637,7 @@ class HfApi:
         repo_id: str,
         *,
         tag: str,
-        token: Optional[str] = None,
+        token: Union[bool, str, None] = None,
         repo_type: Optional[str] = None,
     ) -> None:
         """
@@ -5768,8 +5651,11 @@ class HfApi:
             tag (`str`):
                 The name of the tag to delete.
 
-            token (`str`, *optional*):
-                Authentication token. Will default to the stored token.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
             repo_type (`str`, *optional*):
                 Set to `"dataset"` or `"space"` if tagging a dataset or space, `None` or
@@ -5800,7 +5686,7 @@ class HfApi:
         model_id: str,
         *,
         organization: Optional[str] = None,
-        token: Optional[Union[bool, str]] = None,
+        token: Union[bool, str, None] = None,
     ):
         """
         Returns the repository name for a given model ID and optional
@@ -5812,11 +5698,11 @@ class HfApi:
             organization (`str`, *optional*):
                 If passed, the repository name will be in the organization
                 namespace instead of the user namespace.
-            token (`bool` or `str`, *optional*):
-                A valid authentication token (see https://huggingface.co/settings/token).
-                If `None` or `True` and machine is logged in (through `huggingface-cli login`
-                or [`~huggingface_hub.login`]), token will be retrieved from the cache.
-                If `False`, token is not sent in the request header.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Returns:
             `str`: The repository name in the user's namespace
@@ -5841,7 +5727,7 @@ class HfApi:
         discussion_type: Optional[DiscussionTypeFilter] = None,
         discussion_status: Optional[DiscussionStatusFilter] = None,
         repo_type: Optional[str] = None,
-        token: Optional[str] = None,
+        token: Union[bool, str, None] = None,
     ) -> Iterator[Discussion]:
         """
         Fetches Discussions and Pull Requests for the given repo.
@@ -5866,8 +5752,11 @@ class HfApi:
                 Set to `"dataset"` or `"space"` if fetching from a dataset or
                 space, `None` or `"model"` if fetching from a model. Default is
                 `None`.
-            token (`str`, *optional*):
-                An authentication token (See https://huggingface.co/settings/token).
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Returns:
             `Iterator[Discussion]`: An iterator of [`Discussion`] objects.
@@ -5944,7 +5833,7 @@ class HfApi:
         discussion_num: int,
         *,
         repo_type: Optional[str] = None,
-        token: Optional[str] = None,
+        token: Union[bool, str, None] = None,
     ) -> DiscussionWithDetails:
         """Fetches a Discussion's / Pull Request 's details from the Hub.
 
@@ -5958,8 +5847,11 @@ class HfApi:
                 Set to `"dataset"` or `"space"` if uploading to a dataset or
                 space, `None` or `"model"` if uploading to a model. Default is
                 `None`.
-            token (`str`, *optional*):
-                An authentication token (See https://huggingface.co/settings/token)
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Returns: [`DiscussionWithDetails`]
 
@@ -6019,7 +5911,7 @@ class HfApi:
         repo_id: str,
         title: str,
         *,
-        token: Optional[str] = None,
+        token: Union[bool, str, None] = None,
         description: Optional[str] = None,
         repo_type: Optional[str] = None,
         pull_request: bool = False,
@@ -6038,8 +5930,11 @@ class HfApi:
                 The title of the discussion. It can be up to 200 characters long,
                 and must be at least 3 characters long. Leading and trailing whitespaces
                 will be stripped.
-            token (`str`, *optional*):
-                An authentication token (See https://huggingface.co/settings/token)
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
             description (`str`, *optional*):
                 An optional description for the Pull Request.
                 Defaults to `"Discussion opened with the huggingface_hub Python library"`
@@ -6108,7 +6003,7 @@ class HfApi:
         repo_id: str,
         title: str,
         *,
-        token: Optional[str] = None,
+        token: Union[bool, str, None] = None,
         description: Optional[str] = None,
         repo_type: Optional[str] = None,
     ) -> DiscussionWithDetails:
@@ -6126,8 +6021,11 @@ class HfApi:
                 The title of the discussion. It can be up to 200 characters long,
                 and must be at least 3 characters long. Leading and trailing whitespaces
                 will be stripped.
-            token (`str`, *optional*):
-                An authentication token (See https://huggingface.co/settings/token)
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
             description (`str`, *optional*):
                 An optional description for the Pull Request.
                 Defaults to `"Discussion opened with the huggingface_hub Python library"`
@@ -6167,7 +6065,7 @@ class HfApi:
         discussion_num: int,
         resource: str,
         body: Optional[dict] = None,
-        token: Optional[str] = None,
+        token: Union[bool, str, None] = None,
         repo_type: Optional[str] = None,
     ) -> requests.Response:
         """Internal utility to POST changes to a Discussion or Pull Request"""
@@ -6193,7 +6091,7 @@ class HfApi:
         discussion_num: int,
         comment: str,
         *,
-        token: Optional[str] = None,
+        token: Union[bool, str, None] = None,
         repo_type: Optional[str] = None,
     ) -> DiscussionComment:
         """Creates a new comment on the given Discussion.
@@ -6210,8 +6108,11 @@ class HfApi:
                 Set to `"dataset"` or `"space"` if uploading to a dataset or
                 space, `None` or `"model"` if uploading to a model. Default is
                 `None`.
-            token (`str`, *optional*):
-                An authentication token (See https://huggingface.co/settings/token)
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Returns:
             [`DiscussionComment`]: the newly created comment
@@ -6269,7 +6170,7 @@ class HfApi:
         discussion_num: int,
         new_title: str,
         *,
-        token: Optional[str] = None,
+        token: Union[bool, str, None] = None,
         repo_type: Optional[str] = None,
     ) -> DiscussionTitleChange:
         """Renames a Discussion.
@@ -6286,8 +6187,11 @@ class HfApi:
                 Set to `"dataset"` or `"space"` if uploading to a dataset or
                 space, `None` or `"model"` if uploading to a model. Default is
                 `None`.
-            token (`str`, *optional*):
-                An authentication token (See https://huggingface.co/settings/token)
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Returns:
             [`DiscussionTitleChange`]: the title change event
@@ -6336,7 +6240,7 @@ class HfApi:
         discussion_num: int,
         new_status: Literal["open", "closed"],
         *,
-        token: Optional[str] = None,
+        token: Union[bool, str, None] = None,
         comment: Optional[str] = None,
         repo_type: Optional[str] = None,
     ) -> DiscussionStatusChange:
@@ -6356,8 +6260,11 @@ class HfApi:
                 Set to `"dataset"` or `"space"` if uploading to a dataset or
                 space, `None` or `"model"` if uploading to a model. Default is
                 `None`.
-            token (`str`, *optional*):
-                An authentication token (See https://huggingface.co/settings/token)
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Returns:
             [`DiscussionStatusChange`]: the status change event
@@ -6410,7 +6317,7 @@ class HfApi:
         repo_id: str,
         discussion_num: int,
         *,
-        token: Optional[str] = None,
+        token: Union[bool, str, None] = None,
         comment: Optional[str] = None,
         repo_type: Optional[str] = None,
     ):
@@ -6428,8 +6335,11 @@ class HfApi:
                 Set to `"dataset"` or `"space"` if uploading to a dataset or
                 space, `None` or `"model"` if uploading to a model. Default is
                 `None`.
-            token (`str`, *optional*):
-                An authentication token (See https://huggingface.co/settings/token)
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Returns:
             [`DiscussionStatusChange`]: the status change event
@@ -6465,7 +6375,7 @@ class HfApi:
         comment_id: str,
         new_content: str,
         *,
-        token: Optional[str] = None,
+        token: Union[bool, str, None] = None,
         repo_type: Optional[str] = None,
     ) -> DiscussionComment:
         """Edits a comment on a Discussion / Pull Request.
@@ -6484,8 +6394,11 @@ class HfApi:
                 Set to `"dataset"` or `"space"` if uploading to a dataset or
                 space, `None` or `"model"` if uploading to a model. Default is
                 `None`.
-            token (`str`, *optional*):
-                An authentication token (See https://huggingface.co/settings/token)
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Returns:
             [`DiscussionComment`]: the edited comment
@@ -6521,7 +6434,7 @@ class HfApi:
         discussion_num: int,
         comment_id: str,
         *,
-        token: Optional[str] = None,
+        token: Union[bool, str, None] = None,
         repo_type: Optional[str] = None,
     ) -> DiscussionComment:
         """Hides a comment on a Discussion / Pull Request.
@@ -6542,8 +6455,11 @@ class HfApi:
                 Set to `"dataset"` or `"space"` if uploading to a dataset or
                 space, `None` or `"model"` if uploading to a model. Default is
                 `None`.
-            token (`str`, *optional*):
-                An authentication token (See https://huggingface.co/settings/token)
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Returns:
             [`DiscussionComment`]: the hidden comment
@@ -6577,7 +6493,13 @@ class HfApi:
 
     @validate_hf_hub_args
     def add_space_secret(
-        self, repo_id: str, key: str, value: str, *, description: Optional[str] = None, token: Optional[str] = None
+        self,
+        repo_id: str,
+        key: str,
+        value: str,
+        *,
+        description: Optional[str] = None,
+        token: Union[bool, str, None] = None,
     ) -> None:
         """Adds or updates a secret in a Space.
 
@@ -6593,8 +6515,11 @@ class HfApi:
                 Secret value. Example: `"your_github_api_key"`.
             description (`str`, *optional*):
                 Secret description. Example: `"Github API key to access the Github API"`.
-            token (`str`, *optional*):
-                Hugging Face token. Will default to the locally saved token if not provided.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
         """
         payload = {"key": key, "value": value}
         if description is not None:
@@ -6607,7 +6532,7 @@ class HfApi:
         hf_raise_for_status(r)
 
     @validate_hf_hub_args
-    def delete_space_secret(self, repo_id: str, key: str, *, token: Optional[str] = None) -> None:
+    def delete_space_secret(self, repo_id: str, key: str, *, token: Union[bool, str, None] = None) -> None:
         """Deletes a secret from a Space.
 
         Secrets allow to set secret keys or tokens to a Space without hardcoding them.
@@ -6618,8 +6543,11 @@ class HfApi:
                 ID of the repo to update. Example: `"bigcode/in-the-stack"`.
             key (`str`):
                 Secret key. Example: `"GITHUB_API_KEY"`.
-            token (`str`, *optional*):
-                Hugging Face token. Will default to the locally saved token if not provided.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
         """
         r = get_session().delete(
             f"{self.endpoint}/api/spaces/{repo_id}/secrets",
@@ -6629,7 +6557,7 @@ class HfApi:
         hf_raise_for_status(r)
 
     @validate_hf_hub_args
-    def get_space_variables(self, repo_id: str, *, token: Optional[str] = None) -> Dict[str, SpaceVariable]:
+    def get_space_variables(self, repo_id: str, *, token: Union[bool, str, None] = None) -> Dict[str, SpaceVariable]:
         """Gets all variables from a Space.
 
         Variables allow to set environment variables to a Space without hardcoding them.
@@ -6638,8 +6566,11 @@ class HfApi:
         Args:
             repo_id (`str`):
                 ID of the repo to query. Example: `"bigcode/in-the-stack"`.
-            token (`str`, *optional*):
-                Hugging Face token. Will default to the locally saved token if not provided.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
         """
         r = get_session().get(
             f"{self.endpoint}/api/spaces/{repo_id}/variables",
@@ -6650,7 +6581,13 @@ class HfApi:
 
     @validate_hf_hub_args
     def add_space_variable(
-        self, repo_id: str, key: str, value: str, *, description: Optional[str] = None, token: Optional[str] = None
+        self,
+        repo_id: str,
+        key: str,
+        value: str,
+        *,
+        description: Optional[str] = None,
+        token: Union[bool, str, None] = None,
     ) -> Dict[str, SpaceVariable]:
         """Adds or updates a variable in a Space.
 
@@ -6666,8 +6603,11 @@ class HfApi:
                 Variable value. Example: `"the_model_repo_id"`.
             description (`str`):
                 Description of the variable. Example: `"Model Repo ID of the implemented model"`.
-            token (`str`, *optional*):
-                Hugging Face token. Will default to the locally saved token if not provided.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
         """
         payload = {"key": key, "value": value}
         if description is not None:
@@ -6682,7 +6622,7 @@ class HfApi:
 
     @validate_hf_hub_args
     def delete_space_variable(
-        self, repo_id: str, key: str, *, token: Optional[str] = None
+        self, repo_id: str, key: str, *, token: Union[bool, str, None] = None
     ) -> Dict[str, SpaceVariable]:
         """Deletes a variable from a Space.
 
@@ -6694,8 +6634,11 @@ class HfApi:
                 ID of the repo to update. Example: `"bigcode/in-the-stack"`.
             key (`str`):
                 Variable key. Example: `"MODEL_REPO_ID"`
-            token (`str`, *optional*):
-                Hugging Face token. Will default to the locally saved token if not provided.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
         """
         r = get_session().delete(
             f"{self.endpoint}/api/spaces/{repo_id}/variables",
@@ -6706,15 +6649,17 @@ class HfApi:
         return {k: SpaceVariable(k, v) for k, v in r.json().items()}
 
     @validate_hf_hub_args
-    def get_space_runtime(self, repo_id: str, *, token: Optional[str] = None) -> SpaceRuntime:
+    def get_space_runtime(self, repo_id: str, *, token: Union[bool, str, None] = None) -> SpaceRuntime:
         """Gets runtime information about a Space.
 
         Args:
             repo_id (`str`):
                 ID of the repo to update. Example: `"bigcode/in-the-stack"`.
-            token (`str`, *optional*):
-                Hugging Face token. Will default to the locally saved token if
-                not provided.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
         Returns:
             [`SpaceRuntime`]: Runtime information about a Space including Space stage and hardware.
         """
@@ -6730,7 +6675,7 @@ class HfApi:
         repo_id: str,
         hardware: SpaceHardware,
         *,
-        token: Optional[str] = None,
+        token: Union[bool, str, None] = None,
         sleep_time: Optional[int] = None,
     ) -> SpaceRuntime:
         """Request new hardware for a Space.
@@ -6740,8 +6685,11 @@ class HfApi:
                 ID of the repo to update. Example: `"bigcode/in-the-stack"`.
             hardware (`str` or [`SpaceHardware`]):
                 Hardware on which to run the Space. Example: `"t4-medium"`.
-            token (`str`, *optional*):
-                Hugging Face token. Will default to the locally saved token if not provided.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
             sleep_time (`int`, *optional*):
                 Number of seconds of inactivity to wait before a Space is put to sleep. Set to `-1` if you don't want
                 your Space to sleep (default behavior for upgraded hardware). For free hardware, you can't configure
@@ -6775,7 +6723,9 @@ class HfApi:
         return SpaceRuntime(r.json())
 
     @validate_hf_hub_args
-    def set_space_sleep_time(self, repo_id: str, sleep_time: int, *, token: Optional[str] = None) -> SpaceRuntime:
+    def set_space_sleep_time(
+        self, repo_id: str, sleep_time: int, *, token: Union[bool, str, None] = None
+    ) -> SpaceRuntime:
         """Set a custom sleep time for a Space running on upgraded hardware..
 
         Your Space will go to sleep after X seconds of inactivity. You are not billed when your Space is in "sleep"
@@ -6791,8 +6741,11 @@ class HfApi:
                 your Space to pause (default behavior for upgraded hardware). For free hardware, you can't configure
                 the sleep time (value is fixed to 48 hours of inactivity).
                 See https://huggingface.co/docs/hub/spaces-gpus#sleep-time for more details.
-            token (`str`, *optional*):
-                Hugging Face token. Will default to the locally saved token if not provided.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
         Returns:
             [`SpaceRuntime`]: Runtime information about a Space including Space stage and hardware.
 
@@ -6821,7 +6774,7 @@ class HfApi:
         return runtime
 
     @validate_hf_hub_args
-    def pause_space(self, repo_id: str, *, token: Optional[str] = None) -> SpaceRuntime:
+    def pause_space(self, repo_id: str, *, token: Union[bool, str, None] = None) -> SpaceRuntime:
         """Pause your Space.
 
         A paused Space stops executing until manually restarted by its owner. This is different from the sleeping
@@ -6833,8 +6786,11 @@ class HfApi:
         Args:
             repo_id (`str`):
                 ID of the Space to pause. Example: `"Salesforce/BLIP2"`.
-            token (`str`, *optional*):
-                Hugging Face token. Will default to the locally saved token if not provided.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Returns:
             [`SpaceRuntime`]: Runtime information about your Space including `stage=PAUSED` and requested hardware.
@@ -6858,7 +6814,7 @@ class HfApi:
 
     @validate_hf_hub_args
     def restart_space(
-        self, repo_id: str, *, token: Optional[str] = None, factory_reboot: bool = False
+        self, repo_id: str, *, token: Union[bool, str, None] = None, factory_reboot: bool = False
     ) -> SpaceRuntime:
         """Restart your Space.
 
@@ -6871,8 +6827,11 @@ class HfApi:
         Args:
             repo_id (`str`):
                 ID of the Space to restart. Example: `"Salesforce/BLIP2"`.
-            token (`str`, *optional*):
-                Hugging Face token. Will default to the locally saved token if not provided.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
             factory_reboot (`bool`, *optional*):
                 If `True`, the Space will be rebuilt from scratch without caching any requirements.
 
@@ -6906,7 +6865,7 @@ class HfApi:
         to_id: Optional[str] = None,
         *,
         private: Optional[bool] = None,
-        token: Optional[str] = None,
+        token: Union[bool, str, None] = None,
         exist_ok: bool = False,
         hardware: Optional[SpaceHardware] = None,
         storage: Optional[SpaceStorage] = None,
@@ -6927,8 +6886,11 @@ class HfApi:
                 name as the original Space, but in your account.
             private (`bool`, *optional*):
                 Whether the new Space should be private or not. Defaults to the same privacy as the original Space.
-            token (`str`, *optional*):
-                Hugging Face token. Will default to the locally saved token if not provided.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
             exist_ok (`bool`, *optional*, defaults to `False`):
                 If `True`, do not raise an error if repo already exists.
             hardware (`SpaceHardware` or `str`, *optional*):
@@ -7020,7 +6982,7 @@ class HfApi:
         repo_id: str,
         storage: SpaceStorage,
         *,
-        token: Optional[str] = None,
+        token: Union[bool, str, None] = None,
     ) -> SpaceRuntime:
         """Request persistent storage for a Space.
 
@@ -7029,8 +6991,11 @@ class HfApi:
                 ID of the Space to update. Example: `"HuggingFaceH4/open_llm_leaderboard"`.
             storage (`str` or [`SpaceStorage`]):
                Storage tier. Either 'small', 'medium', or 'large'.
-            token (`str`, *optional*):
-                Hugging Face token. Will default to the locally saved token if not provided.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
         Returns:
             [`SpaceRuntime`]: Runtime information about a Space including Space stage and hardware.
 
@@ -7055,15 +7020,18 @@ class HfApi:
         self,
         repo_id: str,
         *,
-        token: Optional[str] = None,
+        token: Union[bool, str, None] = None,
     ) -> SpaceRuntime:
         """Delete persistent storage for a Space.
 
         Args:
             repo_id (`str`):
                 ID of the Space to update. Example: `"HuggingFaceH4/open_llm_leaderboard"`.
-            token (`str`, *optional*):
-                Hugging Face token. Will default to the locally saved token if not provided.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
         Returns:
             [`SpaceRuntime`]: Runtime information about a Space including Space stage and hardware.
         Raises:
@@ -7083,7 +7051,7 @@ class HfApi:
     #######################
 
     def list_inference_endpoints(
-        self, namespace: Optional[str] = None, *, token: Optional[str] = None
+        self, namespace: Optional[str] = None, *, token: Union[bool, str, None] = None
     ) -> List[InferenceEndpoint]:
         """Lists all inference endpoints for the given namespace.
 
@@ -7091,8 +7059,11 @@ class HfApi:
             namespace (`str`, *optional*):
                 The namespace to list endpoints for. Defaults to the current user. Set to `"*"` to list all endpoints
                 from all namespaces (i.e. personal namespace and all orgs the user belongs to).
-            token (`str`, *optional*):
-                An authentication token (See https://huggingface.co/settings/token).
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Returns:
             List[`InferenceEndpoint`]: A list of all inference endpoints for the given namespace.
@@ -7156,7 +7127,7 @@ class HfApi:
         custom_image: Optional[Dict] = None,
         type: InferenceEndpointType = InferenceEndpointType.PROTECTED,
         namespace: Optional[str] = None,
-        token: Optional[str] = None,
+        token: Union[bool, str, None] = None,
     ) -> InferenceEndpoint:
         """Create a new Inference Endpoint.
 
@@ -7194,8 +7165,11 @@ class HfApi:
                 The type of the Inference Endpoint, which can be `"protected"` (default), `"public"` or `"private"`.
             namespace (`str`, *optional*):
                 The namespace where the Inference Endpoint will be created. Defaults to the current user's namespace.
-            token (`str`, *optional*):
-                An authentication token (See https://huggingface.co/settings/token).
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
             Returns:
                 [`InferenceEndpoint`]: information about the updated Inference Endpoint.
@@ -7292,7 +7266,7 @@ class HfApi:
         return InferenceEndpoint.from_raw(response.json(), namespace=namespace, token=token)
 
     def get_inference_endpoint(
-        self, name: str, *, namespace: Optional[str] = None, token: Optional[str] = None
+        self, name: str, *, namespace: Optional[str] = None, token: Union[bool, str, None] = None
     ) -> InferenceEndpoint:
         """Get information about an Inference Endpoint.
 
@@ -7301,8 +7275,11 @@ class HfApi:
                 The name of the Inference Endpoint to retrieve information about.
             namespace (`str`, *optional*):
                 The namespace in which the Inference Endpoint is located. Defaults to the current user.
-            token (`str`, *optional*):
-                An authentication token (See https://huggingface.co/settings/token).
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Returns:
             [`InferenceEndpoint`]: information about the requested Inference Endpoint.
@@ -7352,7 +7329,7 @@ class HfApi:
         task: Optional[str] = None,
         # Other
         namespace: Optional[str] = None,
-        token: Optional[str] = None,
+        token: Union[bool, str, None] = None,
     ) -> InferenceEndpoint:
         """Update an Inference Endpoint.
 
@@ -7387,8 +7364,11 @@ class HfApi:
 
             namespace (`str`, *optional*):
                 The namespace where the Inference Endpoint will be updated. Defaults to the current user's namespace.
-            token (`str`, *optional*):
-                An authentication token (See https://huggingface.co/settings/token).
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Returns:
             [`InferenceEndpoint`]: information about the updated Inference Endpoint.
@@ -7425,7 +7405,7 @@ class HfApi:
         return InferenceEndpoint.from_raw(response.json(), namespace=namespace, token=token)
 
     def delete_inference_endpoint(
-        self, name: str, *, namespace: Optional[str] = None, token: Optional[str] = None
+        self, name: str, *, namespace: Optional[str] = None, token: Union[bool, str, None] = None
     ) -> None:
         """Delete an Inference Endpoint.
 
@@ -7439,8 +7419,11 @@ class HfApi:
                 The name of the Inference Endpoint to delete.
             namespace (`str`, *optional*):
                 The namespace in which the Inference Endpoint is located. Defaults to the current user.
-            token (`str`, *optional*):
-                An authentication token (See https://huggingface.co/settings/token).
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
         """
         namespace = namespace or self._get_namespace(token=token)
         response = get_session().delete(
@@ -7450,7 +7433,7 @@ class HfApi:
         hf_raise_for_status(response)
 
     def pause_inference_endpoint(
-        self, name: str, *, namespace: Optional[str] = None, token: Optional[str] = None
+        self, name: str, *, namespace: Optional[str] = None, token: Union[bool, str, None] = None
     ) -> InferenceEndpoint:
         """Pause an Inference Endpoint.
 
@@ -7465,8 +7448,11 @@ class HfApi:
                 The name of the Inference Endpoint to pause.
             namespace (`str`, *optional*):
                 The namespace in which the Inference Endpoint is located. Defaults to the current user.
-            token (`str`, *optional*):
-                An authentication token (See https://huggingface.co/settings/token).
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Returns:
             [`InferenceEndpoint`]: information about the paused Inference Endpoint.
@@ -7482,7 +7468,7 @@ class HfApi:
         return InferenceEndpoint.from_raw(response.json(), namespace=namespace, token=token)
 
     def resume_inference_endpoint(
-        self, name: str, *, namespace: Optional[str] = None, token: Optional[str] = None
+        self, name: str, *, namespace: Optional[str] = None, token: Union[bool, str, None] = None
     ) -> InferenceEndpoint:
         """Resume an Inference Endpoint.
 
@@ -7493,8 +7479,11 @@ class HfApi:
                 The name of the Inference Endpoint to resume.
             namespace (`str`, *optional*):
                 The namespace in which the Inference Endpoint is located. Defaults to the current user.
-            token (`str`, *optional*):
-                An authentication token (See https://huggingface.co/settings/token).
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Returns:
             [`InferenceEndpoint`]: information about the resumed Inference Endpoint.
@@ -7510,7 +7499,7 @@ class HfApi:
         return InferenceEndpoint.from_raw(response.json(), namespace=namespace, token=token)
 
     def scale_to_zero_inference_endpoint(
-        self, name: str, *, namespace: Optional[str] = None, token: Optional[str] = None
+        self, name: str, *, namespace: Optional[str] = None, token: Union[bool, str, None] = None
     ) -> InferenceEndpoint:
         """Scale Inference Endpoint to zero.
 
@@ -7525,8 +7514,11 @@ class HfApi:
                 The name of the Inference Endpoint to scale to zero.
             namespace (`str`, *optional*):
                 The namespace in which the Inference Endpoint is located. Defaults to the current user.
-            token (`str`, *optional*):
-                An authentication token (See https://huggingface.co/settings/token).
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Returns:
             [`InferenceEndpoint`]: information about the scaled-to-zero Inference Endpoint.
@@ -7541,7 +7533,7 @@ class HfApi:
 
         return InferenceEndpoint.from_raw(response.json(), namespace=namespace, token=token)
 
-    def _get_namespace(self, token: Optional[str] = None) -> str:
+    def _get_namespace(self, token: Union[bool, str, None] = None) -> str:
         """Get the default namespace for the current user."""
         me = self.whoami(token=token)
         if me["type"] == "user":
@@ -7563,7 +7555,7 @@ class HfApi:
         item: Union[List[str], str, None] = None,
         sort: Optional[Literal["lastModified", "trending", "upvotes"]] = None,
         limit: Optional[int] = None,
-        token: Optional[Union[bool, str]] = None,
+        token: Union[bool, str, None] = None,
     ) -> Iterable[Collection]:
         """List collections on the Huggingface Hub, given some filters.
 
@@ -7583,8 +7575,11 @@ class HfApi:
                 Sort collections by last modified, trending or upvotes.
             limit (`int`, *optional*):
                 Maximum number of collections to be returned.
-            token (`bool` or `str`, *optional*):
-                An authentication token (see https://huggingface.co/settings/token).
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Returns:
             `Iterable[Collection]`: an iterable of [`Collection`] objects.
@@ -7611,14 +7606,17 @@ class HfApi:
         for position, collection_data in enumerate(items):
             yield Collection(position=position, **collection_data)
 
-    def get_collection(self, collection_slug: str, *, token: Optional[str] = None) -> Collection:
+    def get_collection(self, collection_slug: str, *, token: Union[bool, str, None] = None) -> Collection:
         """Gets information about a Collection on the Hub.
 
         Args:
             collection_slug (`str`):
                 Slug of the collection of the Hub. Example: `"TheBloke/recent-models-64f9a55bb3115b4f513ec026"`.
-            token (`str`, *optional*):
-                Hugging Face token. Will default to the locally saved token if not provided.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Returns: [`Collection`]
 
@@ -7655,7 +7653,7 @@ class HfApi:
         description: Optional[str] = None,
         private: bool = False,
         exists_ok: bool = False,
-        token: Optional[str] = None,
+        token: Union[bool, str, None] = None,
     ) -> Collection:
         """Create a new Collection on the Hub.
 
@@ -7670,8 +7668,11 @@ class HfApi:
                 Whether the collection should be private or not. Defaults to `False` (i.e. public collection).
             exists_ok (`bool`, *optional*):
                 If `True`, do not raise an error if collection already exists.
-            token (`str`, *optional*):
-                Hugging Face token. Will default to the locally saved token if not provided.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Returns: [`Collection`]
 
@@ -7721,7 +7722,7 @@ class HfApi:
         position: Optional[int] = None,
         private: Optional[bool] = None,
         theme: Optional[str] = None,
-        token: Optional[str] = None,
+        token: Union[bool, str, None] = None,
     ) -> Collection:
         """Update metadata of a collection on the Hub.
 
@@ -7740,8 +7741,11 @@ class HfApi:
                 Whether the collection should be private or not.
             theme (`str`, *optional*):
                 Theme of the collection on the Hub.
-            token (`str`, *optional*):
-                Hugging Face token. Will default to the locally saved token if not provided.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Returns: [`Collection`]
 
@@ -7778,7 +7782,7 @@ class HfApi:
         return Collection(**{**r.json()["data"], "endpoint": self.endpoint})
 
     def delete_collection(
-        self, collection_slug: str, *, missing_ok: bool = False, token: Optional[str] = None
+        self, collection_slug: str, *, missing_ok: bool = False, token: Union[bool, str, None] = None
     ) -> None:
         """Delete a collection on the Hub.
 
@@ -7787,8 +7791,11 @@ class HfApi:
                 Slug of the collection to delete. Example: `"TheBloke/recent-models-64f9a55bb3115b4f513ec026"`.
             missing_ok (`bool`, *optional*):
                 If `True`, do not raise an error if collection doesn't exists.
-            token (`str`, *optional*):
-                Hugging Face token. Will default to the locally saved token if not provided.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Example:
 
@@ -7823,7 +7830,7 @@ class HfApi:
         *,
         note: Optional[str] = None,
         exists_ok: bool = False,
-        token: Optional[str] = None,
+        token: Union[bool, str, None] = None,
     ) -> Collection:
         """Add an item to a collection on the Hub.
 
@@ -7839,8 +7846,11 @@ class HfApi:
                 A note to attach to the item in the collection. The maximum size for a note is 500 characters.
             exists_ok (`bool`, *optional*):
                 If `True`, do not raise an error if item already exists.
-            token (`str`, *optional*):
-                Hugging Face token. Will default to the locally saved token if not provided.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Returns: [`Collection`]
 
@@ -7901,7 +7911,7 @@ class HfApi:
         *,
         note: Optional[str] = None,
         position: Optional[int] = None,
-        token: Optional[str] = None,
+        token: Union[bool, str, None] = None,
     ) -> None:
         """Update an item in a collection.
 
@@ -7915,8 +7925,11 @@ class HfApi:
                 A note to attach to the item in the collection. The maximum size for a note is 500 characters.
             position (`int`, *optional*):
                 New position of the item in the collection.
-            token (`str`, *optional*):
-                Hugging Face token. Will default to the locally saved token if not provided.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Example:
 
@@ -7950,7 +7963,7 @@ class HfApi:
         item_object_id: str,
         *,
         missing_ok: bool = False,
-        token: Optional[str] = None,
+        token: Union[bool, str, None] = None,
     ) -> None:
         """Delete an item from a collection.
 
@@ -7962,8 +7975,11 @@ class HfApi:
                 It must be retrieved from a [`CollectionItem`] object. Example: `collection.items[0]._id`.
             missing_ok (`bool`, *optional*):
                 If `True`, do not raise an error if item doesn't exists.
-            token (`str`, *optional*):
-                Hugging Face token. Will default to the locally saved token if not provided.
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Example:
 
@@ -7999,7 +8015,7 @@ class HfApi:
 
     @validate_hf_hub_args
     def list_pending_access_requests(
-        self, repo_id: str, *, repo_type: Optional[str] = None, token: Optional[str] = None
+        self, repo_id: str, *, repo_type: Optional[str] = None, token: Union[bool, str, None] = None
     ) -> List[AccessRequest]:
         """
         Get pending access requests for a given gated repo.
@@ -8016,8 +8032,11 @@ class HfApi:
             repo_type (`str`, *optional*):
                 The type of the repo to get access requests for. Must be one of `model`, `dataset` or `space`.
                 Defaults to `model`.
-            token (`str`, *optional*):
-                A valid authentication token (see https://huggingface.co/settings/token).
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Returns:
             `List[AccessRequest]`: A list of [`AccessRequest`] objects. Each time contains a `username`, `email`,
@@ -8060,7 +8079,7 @@ class HfApi:
 
     @validate_hf_hub_args
     def list_accepted_access_requests(
-        self, repo_id: str, *, repo_type: Optional[str] = None, token: Optional[str] = None
+        self, repo_id: str, *, repo_type: Optional[str] = None, token: Union[bool, str, None] = None
     ) -> List[AccessRequest]:
         """
         Get accepted access requests for a given gated repo.
@@ -8079,8 +8098,11 @@ class HfApi:
             repo_type (`str`, *optional*):
                 The type of the repo to get access requests for. Must be one of `model`, `dataset` or `space`.
                 Defaults to `model`.
-            token (`str`, *optional*):
-                A valid authentication token (see https://huggingface.co/settings/token).
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Returns:
             `List[AccessRequest]`: A list of [`AccessRequest`] objects. Each time contains a `username`, `email`,
@@ -8119,7 +8141,7 @@ class HfApi:
 
     @validate_hf_hub_args
     def list_rejected_access_requests(
-        self, repo_id: str, *, repo_type: Optional[str] = None, token: Optional[str] = None
+        self, repo_id: str, *, repo_type: Optional[str] = None, token: Union[bool, str, None] = None
     ) -> List[AccessRequest]:
         """
         Get rejected access requests for a given gated repo.
@@ -8138,8 +8160,11 @@ class HfApi:
             repo_type (`str`, *optional*):
                 The type of the repo to get access requests for. Must be one of `model`, `dataset` or `space`.
                 Defaults to `model`.
-            token (`str`, *optional*):
-                A valid authentication token (see https://huggingface.co/settings/token).
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Returns:
             `List[AccessRequest]`: A list of [`AccessRequest`] objects. Each time contains a `username`, `email`,
@@ -8181,7 +8206,7 @@ class HfApi:
         repo_id: str,
         status: Literal["accepted", "rejected", "pending"],
         repo_type: Optional[str] = None,
-        token: Optional[str] = None,
+        token: Union[bool, str, None] = None,
     ) -> List[AccessRequest]:
         if repo_type not in REPO_TYPES:
             raise ValueError(f"Invalid repo type, must be one of {REPO_TYPES}")
@@ -8207,7 +8232,7 @@ class HfApi:
 
     @validate_hf_hub_args
     def cancel_access_request(
-        self, repo_id: str, user: str, *, repo_type: Optional[str] = None, token: Optional[str] = None
+        self, repo_id: str, user: str, *, repo_type: Optional[str] = None, token: Union[bool, str, None] = None
     ) -> None:
         """
         Cancel an access request from a user for a given gated repo.
@@ -8224,8 +8249,11 @@ class HfApi:
             repo_type (`str`, *optional*):
                 The type of the repo to cancel access request for. Must be one of `model`, `dataset` or `space`.
                 Defaults to `model`.
-            token (`str`, *optional*):
-                A valid authentication token (see https://huggingface.co/settings/token).
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Raises:
             `HTTPError`:
@@ -8244,7 +8272,7 @@ class HfApi:
 
     @validate_hf_hub_args
     def accept_access_request(
-        self, repo_id: str, user: str, *, repo_type: Optional[str] = None, token: Optional[str] = None
+        self, repo_id: str, user: str, *, repo_type: Optional[str] = None, token: Union[bool, str, None] = None
     ) -> None:
         """
         Accept an access request from a user for a given gated repo.
@@ -8263,8 +8291,11 @@ class HfApi:
             repo_type (`str`, *optional*):
                 The type of the repo to accept access request for. Must be one of `model`, `dataset` or `space`.
                 Defaults to `model`.
-            token (`str`, *optional*):
-                A valid authentication token (see https://huggingface.co/settings/token).
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Raises:
             `HTTPError`:
@@ -8283,7 +8314,7 @@ class HfApi:
 
     @validate_hf_hub_args
     def reject_access_request(
-        self, repo_id: str, user: str, *, repo_type: Optional[str] = None, token: Optional[str] = None
+        self, repo_id: str, user: str, *, repo_type: Optional[str] = None, token: Union[bool, str, None] = None
     ) -> None:
         """
         Reject an access request from a user for a given gated repo.
@@ -8302,8 +8333,11 @@ class HfApi:
             repo_type (`str`, *optional*):
                 The type of the repo to reject access request for. Must be one of `model`, `dataset` or `space`.
                 Defaults to `model`.
-            token (`str`, *optional*):
-                A valid authentication token (see https://huggingface.co/settings/token).
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Raises:
             `HTTPError`:
@@ -8327,7 +8361,7 @@ class HfApi:
         user: str,
         status: Literal["accepted", "rejected", "pending"],
         repo_type: Optional[str] = None,
-        token: Optional[str] = None,
+        token: Union[bool, str, None] = None,
     ) -> None:
         if repo_type not in REPO_TYPES:
             raise ValueError(f"Invalid repo type, must be one of {REPO_TYPES}")
@@ -8343,7 +8377,7 @@ class HfApi:
 
     @validate_hf_hub_args
     def grant_access(
-        self, repo_id: str, user: str, *, repo_type: Optional[str] = None, token: Optional[str] = None
+        self, repo_id: str, user: str, *, repo_type: Optional[str] = None, token: Union[bool, str, None] = None
     ) -> None:
         """
         Grant access to a user for a given gated repo.
@@ -8362,8 +8396,11 @@ class HfApi:
             repo_type (`str`, *optional*):
                 The type of the repo to grant access to. Must be one of `model`, `dataset` or `space`.
                 Defaults to `model`.
-            token (`str`, *optional*):
-                A valid authentication token (see https://huggingface.co/settings/token).
+            token (Union[bool, str, None], optional):
+                A valid user access token (string). Defaults to the locally saved
+                token, which is the recommended method for authentication (see
+                https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
+                To disable authentication, pass `False`.
 
         Raises:
             `HTTPError`:
@@ -8395,7 +8432,7 @@ class HfApi:
 
     def _build_hf_headers(
         self,
-        token: Optional[Union[bool, str]] = None,
+        token: Union[bool, str, None] = None,
         is_write_action: bool = False,
         library_name: Optional[str] = None,
         library_version: Optional[str] = None,
@@ -8422,9 +8459,9 @@ class HfApi:
         repo_id: str,
         repo_type: Optional[str],
         revision: Optional[str],
-        token: Optional[str],
         path_in_repo: str,
         delete_patterns: Optional[Union[List[str], str]],
+        token: Union[bool, str, None] = None,
     ) -> List[CommitOperationDelete]:
         """Generate the list of Delete operations for a commit to delete files from a repo.
 
@@ -8457,6 +8494,98 @@ class HfApi:
             if relpath_to_abspath[relpath] != ".gitattributes"
         ]
 
+    def get_user_overview(self, username: str) -> User:
+        """
+        Get an overview of a user on the Hub.
+
+        Args:
+            username (`str`):
+                Username of the user to get an overview of.
+
+        Returns:
+            `User`: A [`User`] object with the user's overview.
+
+        Raises:
+            `HTTPError`:
+                HTTP 404 If the user does not exist on the Hub.
+        """
+        r = get_session().get(f"{ENDPOINT}/api/users/{username}/overview")
+
+        hf_raise_for_status(r)
+        return User(**r.json())
+
+    def list_organization_members(self, organization: str) -> Iterable[User]:
+        """
+        List of members of an organization on the Hub.
+
+        Args:
+            organization (`str`):
+                Name of the organization to get the members of.
+
+        Returns:
+            `Iterable[User]`: A list of [`User`] objects with the members of the organization.
+
+        Raises:
+            `HTTPError`:
+                HTTP 404 If the organization does not exist on the Hub.
+
+        """
+
+        r = get_session().get(f"{ENDPOINT}/api/organizations/{organization}/members")
+
+        hf_raise_for_status(r)
+
+        for member in r.json():
+            yield User(**member)
+
+    def list_user_followers(self, username: str) -> Iterable[User]:
+        """
+        Get the list of followers of a user on the Hub.
+
+        Args:
+            username (`str`):
+                Username of the user to get the followers of.
+
+        Returns:
+            `Iterable[User]`: A list of [`User`] objects with the followers of the user.
+
+        Raises:
+            `HTTPError`:
+                HTTP 404 If the user does not exist on the Hub.
+
+        """
+
+        r = get_session().get(f"{ENDPOINT}/api/users/{username}/followers")
+
+        hf_raise_for_status(r)
+
+        for follower in r.json():
+            yield User(**follower)
+
+    def list_user_following(self, username: str) -> Iterable[User]:
+        """
+        Get the list of users followed by a user on the Hub.
+
+        Args:
+            username (`str`):
+                Username of the user to get the users followed by.
+
+        Returns:
+            `Iterable[User]`: A list of [`User`] objects with the users followed by the user.
+
+        Raises:
+            `HTTPError`:
+                HTTP 404 If the user does not exist on the Hub.
+
+        """
+
+        r = get_session().get(f"{ENDPOINT}/api/users/{username}/following")
+
+        hf_raise_for_status(r)
+
+        for followed_user in r.json():
+            yield User(**followed_user)
+
 
 def _prepare_upload_folder_additions(
     folder_path: Union[str, Path],
@@ -8530,7 +8659,6 @@ repo_info = api.repo_info
 list_repo_files = api.list_repo_files
 list_repo_refs = api.list_repo_refs
 list_repo_commits = api.list_repo_commits
-list_files_info = api.list_files_info
 list_repo_tree = api.list_repo_tree
 get_paths_info = api.get_paths_info
 
@@ -8625,3 +8753,9 @@ cancel_access_request = api.cancel_access_request
 accept_access_request = api.accept_access_request
 reject_access_request = api.reject_access_request
 grant_access = api.grant_access
+
+# User API
+get_user_overview = api.get_user_overview
+list_organization_members = api.list_organization_members
+list_user_followers = api.list_user_followers
+list_user_following = api.list_user_following