huggingface-hub 0.36.0rc0__py3-none-any.whl → 1.0.0__py3-none-any.whl

huggingface_hub/hf_api.py

@@ -33,22 +33,17 @@ from typing import (
     Any,
     BinaryIO,
     Callable,
-    Dict,
     Iterable,
     Iterator,
-    List,
     Literal,
     Optional,
-    Tuple,
-    Type,
     TypeVar,
     Union,
     overload,
 )
 from urllib.parse import quote
 
-import requests
-from requests.exceptions import HTTPError
+import httpx
 from tqdm.auto import tqdm as base_tqdm
 from tqdm.contrib.concurrent import thread_map
 
@@ -76,41 +71,18 @@ from .community import (
     DiscussionWithDetails,
     deserialize_event,
 )
-from .constants import (
-    DEFAULT_ETAG_TIMEOUT,  # noqa: F401 # kept for backward compatibility
-    DEFAULT_REQUEST_TIMEOUT,  # noqa: F401 # kept for backward compatibility
-    DEFAULT_REVISION,  # noqa: F401 # kept for backward compatibility
-    DISCUSSION_STATUS,  # noqa: F401 # kept for backward compatibility
-    DISCUSSION_TYPES,  # noqa: F401 # kept for backward compatibility
-    ENDPOINT,  # noqa: F401 # kept for backward compatibility
-    INFERENCE_ENDPOINTS_ENDPOINT,  # noqa: F401 # kept for backward compatibility
-    REGEX_COMMIT_OID,  # noqa: F401 # kept for backward compatibility
-    REPO_TYPE_MODEL,  # noqa: F401 # kept for backward compatibility
-    REPO_TYPES,  # noqa: F401 # kept for backward compatibility
-    REPO_TYPES_MAPPING,  # noqa: F401 # kept for backward compatibility
-    REPO_TYPES_URL_PREFIXES,  # noqa: F401 # kept for backward compatibility
-    SAFETENSORS_INDEX_FILE,  # noqa: F401 # kept for backward compatibility
-    SAFETENSORS_MAX_HEADER_LENGTH,  # noqa: F401 # kept for backward compatibility
-    SAFETENSORS_SINGLE_FILE,  # noqa: F401 # kept for backward compatibility
-    SPACES_SDK_TYPES,  # noqa: F401 # kept for backward compatibility
-    WEBHOOK_DOMAIN_T,  # noqa: F401 # kept for backward compatibility
-    DiscussionStatusFilter,  # noqa: F401 # kept for backward compatibility
-    DiscussionTypeFilter,  # noqa: F401 # kept for backward compatibility
-)
 from .errors import (
     BadRequestError,
-    EntryNotFoundError,
     GatedRepoError,
     HfHubHTTPError,
+    RemoteEntryNotFoundError,
     RepositoryNotFoundError,
     RevisionNotFoundError,
 )
-from .file_download import HfFileMetadata, get_hf_file_metadata, hf_hub_url
+from .file_download import DryRunFileInfo, HfFileMetadata, get_hf_file_metadata, hf_hub_url
 from .repocard_data import DatasetCardData, ModelCardData, SpaceCardData
 from .utils import (
     DEFAULT_IGNORE_PATTERNS,
-    HfFolder,  # noqa: F401 # kept for backward compatibility
-    LocalTokenNotFoundError,
     NotASafetensorsRepoError,
     SafetensorsFileMetadata,
     SafetensorsParsingError,
@@ -131,7 +103,7 @@ from .utils import (
 )
 from .utils import tqdm as hf_tqdm
 from .utils._auth import _get_token_from_environment, _get_token_from_file, _get_token_from_google_colab
-from .utils._deprecation import _deprecate_arguments, _deprecate_method
+from .utils._deprecation import _deprecate_arguments
 from .utils._typing import CallableT
 from .utils.endpoint_helpers import _is_emission_within_threshold
 
@@ -173,7 +145,6 @@ ExpandModelProperty_T = Literal[
     "trendingScore",
     "usedStorage",
     "widgetData",
-    "xetEnabled",
 ]
 
 ExpandDatasetProperty_T = Literal[
@@ -196,7 +167,6 @@ ExpandDatasetProperty_T = Literal[
     "tags",
     "trendingScore",
     "usedStorage",
-    "xetEnabled",
 ]
 
 ExpandSpaceProperty_T = Literal[
@@ -218,7 +188,6 @@ ExpandSpaceProperty_T = Literal[
     "tags",
     "trendingScore",
     "usedStorage",
-    "xetEnabled",
 ]
 
 USERNAME_PLACEHOLDER = "hf_user"
@@ -236,7 +205,7 @@ _AUTH_CHECK_NO_REPO_ERROR_MESSAGE = (
 logger = logging.get_logger(__name__)
 
 
-def repo_type_and_id_from_hf_id(hf_id: str, hub_url: Optional[str] = None) -> Tuple[Optional[str], Optional[str], str]:
+def repo_type_and_id_from_hf_id(hf_id: str, hub_url: Optional[str] = None) -> tuple[Optional[str], Optional[str], str]:
     """
     Returns the repo type and ID from a huggingface.co URL linking to a
     repository
@@ -346,8 +315,8 @@ class BlobLfsInfo(dict):
 class BlobSecurityInfo(dict):
     safe: bool  # duplicate information with "status" field, keeping it for backward compatibility
     status: str
-    av_scan: Optional[Dict]
-    pickle_import_scan: Optional[Dict]
+    av_scan: Optional[dict]
+    pickle_import_scan: Optional[dict]
 
     def __post_init__(self):  # hack to make BlogSecurityInfo backward compatible
         self.update(asdict(self))
@@ -367,7 +336,7 @@ class TransformersInfo(dict):
 
 @dataclass
 class SafeTensorsInfo(dict):
-    parameters: Dict[str, int]
+    parameters: dict[str, int]
     total: int
 
     def __post_init__(self):  # hack to make SafeTensorsInfo backward compatible
@@ -410,12 +379,6 @@ class CommitInfo(str):
 
         repo_url (`RepoUrl`):
             Repo URL of the commit containing info like repo_id, repo_type, etc.
-
-        _url (`str`, *optional*):
-            Legacy url for `str` compatibility. Can be the url to the uploaded file on the Hub (if returned by
-            [`upload_file`]), to the uploaded folder on the Hub (if returned by [`upload_folder`]) or to the commit on
-            the Hub (if returned by [`create_commit`]). Defaults to `commit_url`. It is deprecated to use this
-            attribute. Please use `commit_url` instead.
     """
 
     commit_url: str
@@ -429,13 +392,10 @@ class CommitInfo(str):
 
     # Computed from `pr_url` in `__post_init__`
     pr_revision: Optional[str] = field(init=False)
-    pr_num: Optional[str] = field(init=False)
-
-    # legacy url for `str` compatibility (ex: url to uploaded file, url to uploaded folder, url to PR, etc.)
-    _url: str = field(repr=False, default=None)  # type: ignore  # defaults to `commit_url`
+    pr_num: Optional[int] = field(init=False)
 
-    def __new__(cls, *args, commit_url: str, _url: Optional[str] = None, **kwargs):
-        return str.__new__(cls, _url or commit_url)
+    def __new__(cls, *args, commit_url: str, **kwargs):
+        return str.__new__(cls, commit_url)
 
     def __post_init__(self):
         """Populate pr-related fields after initialization.
@@ -470,7 +430,7 @@ class AccessRequest:
             Timestamp of the request.
         status (`Literal["pending", "accepted", "rejected"]`):
             Status of the request. Can be one of `["pending", "accepted", "rejected"]`.
-        fields (`Dict[str, Any]`, *optional*):
+        fields (`dict[str, Any]`, *optional*):
             Additional fields filled by the user in the gate form.
     """
 
@@ -481,7 +441,7 @@ class AccessRequest:
     status: Literal["pending", "accepted", "rejected"]
 
     # Additional fields filled by the user in the gate form
-    fields: Optional[Dict[str, Any]] = None
+    fields: Optional[dict[str, Any]] = None
 
 
 @dataclass
@@ -512,9 +472,9 @@ class WebhookInfo:
             URL of the webhook.
         job (`JobSpec`, *optional*):
             Specifications of the Job to trigger.
-        watched (`List[WebhookWatchedItem]`):
+        watched (`list[WebhookWatchedItem]`):
             List of items watched by the webhook, see [`WebhookWatchedItem`].
-        domains (`List[WEBHOOK_DOMAIN_T]`):
+        domains (`list[WEBHOOK_DOMAIN_T]`):
             List of domains the webhook is watching. Can be one of `["repo", "discussions"]`.
         secret (`str`, *optional*):
             Secret of the webhook.
@@ -525,8 +485,8 @@ class WebhookInfo:
     id: str
     url: Optional[str]
     job: Optional[JobSpec]
-    watched: List[WebhookWatchedItem]
-    domains: List[constants.WEBHOOK_DOMAIN_T]
+    watched: list[WebhookWatchedItem]
+    domains: list[constants.WEBHOOK_DOMAIN_T]
     secret: Optional[str]
     disabled: bool
 
@@ -771,17 +731,17 @@ class ModelInfo:
         gated (`Literal["auto", "manual", False]`, *optional*):
             Is the repo gated.
             If so, whether there is manual or automatic approval.
-        gguf (`Dict`, *optional*):
+        gguf (`dict`, *optional*):
             GGUF information of the model.
         inference (`Literal["warm"]`, *optional*):
             Status of the model on Inference Providers. Warm if the model is served by at least one provider.
-        inference_provider_mapping (`List[InferenceProviderMapping]`, *optional*):
+        inference_provider_mapping (`list[InferenceProviderMapping]`, *optional*):
             A list of [`InferenceProviderMapping`] ordered after the user's provider order.
         likes (`int`):
             Number of likes of the model.
         library_name (`str`, *optional*):
             Library associated with the model.
-        tags (`List[str]`):
+        tags (`list[str]`):
             List of tags of the model. Compared to `card_data.tags`, contains extra tags computed by the Hub
             (e.g. supported libraries, model's arXiv).
         pipeline_tag (`str`, *optional*):
@@ -790,9 +750,9 @@ class ModelInfo:
             Mask token used by the model.
         widget_data (`Any`, *optional*):
             Widget data associated with the model.
-        model_index (`Dict`, *optional*):
+        model_index (`dict`, *optional*):
             Model index for evaluation.
-        config (`Dict`, *optional*):
+        config (`dict`, *optional*):
             Model configuration.
         transformers_info (`TransformersInfo`, *optional*):
             Transformers-specific info (auto class, processor, etc.) associated with the model.
@@ -800,13 +760,13 @@ class ModelInfo:
             Trending score of the model.
         card_data (`ModelCardData`, *optional*):
             Model Card Metadata  as a [`huggingface_hub.repocard_data.ModelCardData`] object.
-        siblings (`List[RepoSibling]`):
+        siblings (`list[RepoSibling]`):
             List of [`huggingface_hub.hf_api.RepoSibling`] objects that constitute the model.
-        spaces (`List[str]`, *optional*):
+        spaces (`list[str]`, *optional*):
             List of spaces using the model.
         safetensors (`SafeTensorsInfo`, *optional*):
             Model's safetensors information.
-        security_repo_status (`Dict`, *optional*):
+        security_repo_status (`dict`, *optional*):
             Model's security scan status.
     """
 
@@ -820,25 +780,24 @@ class ModelInfo:
     downloads: Optional[int]
     downloads_all_time: Optional[int]
     gated: Optional[Literal["auto", "manual", False]]
-    gguf: Optional[Dict]
+    gguf: Optional[dict]
     inference: Optional[Literal["warm"]]
-    inference_provider_mapping: Optional[List[InferenceProviderMapping]]
+    inference_provider_mapping: Optional[list[InferenceProviderMapping]]
     likes: Optional[int]
     library_name: Optional[str]
-    tags: Optional[List[str]]
+    tags: Optional[list[str]]
     pipeline_tag: Optional[str]
     mask_token: Optional[str]
     card_data: Optional[ModelCardData]
     widget_data: Optional[Any]
-    model_index: Optional[Dict]
-    config: Optional[Dict]
+    model_index: Optional[dict]
+    config: Optional[dict]
     transformers_info: Optional[TransformersInfo]
     trending_score: Optional[int]
-    siblings: Optional[List[RepoSibling]]
-    spaces: Optional[List[str]]
+    siblings: Optional[list[RepoSibling]]
+    spaces: Optional[list[str]]
     safetensors: Optional[SafeTensorsInfo]
-    security_repo_status: Optional[Dict]
-    xet_enabled: Optional[bool]
+    security_repo_status: Optional[dict]
 
     def __init__(self, **kwargs):
         self.id = kwargs.pop("id")
@@ -926,7 +885,6 @@ class ModelInfo:
             else None
         )
         self.security_repo_status = kwargs.pop("securityRepoStatus", None)
-        self.xet_enabled = kwargs.pop("xetEnabled", None)
         # backwards compatibility
         self.lastModified = self.last_modified
         self.cardData = self.card_data
@@ -969,11 +927,11 @@ class DatasetInfo:
             Cumulated number of downloads of the model since its creation.
         likes (`int`):
             Number of likes of the dataset.
-        tags (`List[str]`):
+        tags (`list[str]`):
             List of tags of the dataset.
         card_data (`DatasetCardData`, *optional*):
             Model Card Metadata  as a [`huggingface_hub.repocard_data.DatasetCardData`] object.
-        siblings (`List[RepoSibling]`):
+        siblings (`list[RepoSibling]`):
             List of [`huggingface_hub.hf_api.RepoSibling`] objects that constitute the dataset.
         paperswithcode_id (`str`, *optional*):
             Papers with code ID of the dataset.
@@ -993,11 +951,10 @@ class DatasetInfo:
     downloads_all_time: Optional[int]
     likes: Optional[int]
     paperswithcode_id: Optional[str]
-    tags: Optional[List[str]]
+    tags: Optional[list[str]]
     trending_score: Optional[int]
     card_data: Optional[DatasetCardData]
-    siblings: Optional[List[RepoSibling]]
-    xet_enabled: Optional[bool]
+    siblings: Optional[list[RepoSibling]]
 
     def __init__(self, **kwargs):
         self.id = kwargs.pop("id")
@@ -1043,7 +1000,6 @@ class DatasetInfo:
             if siblings is not None
             else None
         )
-        self.xet_enabled = kwargs.pop("xetEnabled", None)
         # backwards compatibility
         self.lastModified = self.last_modified
         self.cardData = self.card_data
@@ -1085,9 +1041,9 @@ class SpaceInfo:
             Subdomain of the Space.
         likes (`int`):
             Number of likes of the Space.
-        tags (`List[str]`):
+        tags (`list[str]`):
             List of tags of the Space.
-        siblings (`List[RepoSibling]`):
+        siblings (`list[RepoSibling]`):
             List of [`huggingface_hub.hf_api.RepoSibling`] objects that constitute the Space.
         card_data (`SpaceCardData`, *optional*):
             Space Card Metadata  as a [`huggingface_hub.repocard_data.SpaceCardData`] object.
@@ -1095,9 +1051,9 @@ class SpaceInfo:
             Space runtime information as a [`huggingface_hub.hf_api.SpaceRuntime`] object.
         sdk (`str`, *optional*):
             SDK used by the Space.
-        models (`List[str]`, *optional*):
+        models (`list[str]`, *optional*):
             List of models used by the Space.
-        datasets (`List[str]`, *optional*):
+        datasets (`list[str]`, *optional*):
             List of datasets used by the Space.
         trending_score (`int`, *optional*):
             Trending score of the Space.
@@ -1115,14 +1071,13 @@ class SpaceInfo:
     subdomain: Optional[str]
     likes: Optional[int]
     sdk: Optional[str]
-    tags: Optional[List[str]]
-    siblings: Optional[List[RepoSibling]]
+    tags: Optional[list[str]]
+    siblings: Optional[list[RepoSibling]]
     trending_score: Optional[int]
     card_data: Optional[SpaceCardData]
     runtime: Optional[SpaceRuntime]
-    models: Optional[List[str]]
-    datasets: Optional[List[str]]
-    xet_enabled: Optional[bool]
+    models: Optional[list[str]]
+    datasets: Optional[list[str]]
 
     def __init__(self, **kwargs):
         self.id = kwargs.pop("id")
@@ -1171,7 +1126,6 @@ class SpaceInfo:
         self.runtime = SpaceRuntime(runtime) if runtime else None
         self.models = kwargs.pop("models", None)
         self.datasets = kwargs.pop("datasets", None)
-        self.xet_enabled = kwargs.pop("xetEnabled", None)
         # backwards compatibility
         self.lastModified = self.last_modified
         self.cardData = self.card_data
@@ -1209,7 +1163,7 @@ class CollectionItem:
         id: str,
         type: CollectionItemType_T,
         position: int,
-        note: Optional[Dict] = None,
+        note: Optional[dict] = None,
         **kwargs,
     ) -> None:
         self.item_object_id: str = _id  # id in database
@@ -1235,7 +1189,7 @@ class Collection:
             Title of the collection. E.g. `"Recent models"`.
         owner (`str`):
             Owner of the collection. E.g. `"TheBloke"`.
-        items (`List[CollectionItem]`):
+        items (`list[CollectionItem]`):
             List of items in the collection.
         last_updated (`datetime`):
             Date of the last update of the collection.
@@ -1256,7 +1210,7 @@ class Collection:
     slug: str
     title: str
     owner: str
-    items: List[CollectionItem]
+    items: list[CollectionItem]
     last_updated: datetime
     position: int
     private: bool
@@ -1313,22 +1267,22 @@ class GitRefs:
     Object is returned by [`list_repo_refs`].
 
     Attributes:
-        branches (`List[GitRefInfo]`):
+        branches (`list[GitRefInfo]`):
             A list of [`GitRefInfo`] containing information about branches on the repo.
-        converts (`List[GitRefInfo]`):
+        converts (`list[GitRefInfo]`):
             A list of [`GitRefInfo`] containing information about "convert" refs on the repo.
             Converts are refs used (internally) to push preprocessed data in Dataset repos.
-        tags (`List[GitRefInfo]`):
+        tags (`list[GitRefInfo]`):
             A list of [`GitRefInfo`] containing information about tags on the repo.
-        pull_requests (`List[GitRefInfo]`, *optional*):
+        pull_requests (`list[GitRefInfo]`, *optional*):
             A list of [`GitRefInfo`] containing information about pull requests on the repo.
             Only returned if `include_prs=True` is set.
     """
 
-    branches: List[GitRefInfo]
-    converts: List[GitRefInfo]
-    tags: List[GitRefInfo]
-    pull_requests: Optional[List[GitRefInfo]] = None
+    branches: list[GitRefInfo]
+    converts: list[GitRefInfo]
+    tags: list[GitRefInfo]
+    pull_requests: Optional[list[GitRefInfo]] = None
 
 
 @dataclass
@@ -1339,7 +1293,7 @@ class GitCommitInfo:
     Attributes:
         commit_id (`str`):
             OID of the commit (e.g. `"e7da7f221d5bf496a48136c0cd264e630fe9fcc8"`)
-        authors (`List[str]`):
+        authors (`list[str]`):
             List of authors of the commit.
         created_at (`datetime`):
             Datetime when the commit was created.
@@ -1355,7 +1309,7 @@ class GitCommitInfo:
 
     commit_id: str
 
-    authors: List[str]
+    authors: list[str]
     created_at: datetime
     title: str
     message: str
@@ -1374,11 +1328,11 @@ class UserLikes:
             Name of the user for which we fetched the likes.
         total (`int`):
             Total number of likes.
-        datasets (`List[str]`):
+        datasets (`list[str]`):
             List of datasets liked by the user (as repo_ids).
-        models (`List[str]`):
+        models (`list[str]`):
             List of models liked by the user (as repo_ids).
-        spaces (`List[str]`):
+        spaces (`list[str]`):
             List of spaces liked by the user (as repo_ids).
     """
 
@@ -1387,9 +1341,9 @@ class UserLikes:
     total: int
 
     # User likes
-    datasets: List[str]
-    models: List[str]
-    spaces: List[str]
+    datasets: list[str]
+    models: list[str]
+    spaces: list[str]
 
 
 @dataclass
@@ -1507,7 +1461,7 @@ class User:
     num_likes: Optional[int] = None
     num_following: Optional[int] = None
     num_followers: Optional[int] = None
-    orgs: List[Organization] = field(default_factory=list)
+    orgs: list[Organization] = field(default_factory=list)
 
     def __init__(self, **kwargs) -> None:
         self.username = kwargs.pop("user", "")
@@ -1540,7 +1494,7 @@ class PaperInfo:
     Attributes:
         id (`str`):
             arXiv paper ID.
-        authors (`List[str]`, **optional**):
+        authors (`list[str]`, **optional**):
             Names of paper authors
         published_at (`datetime`, **optional**):
             Date paper published.
@@ -1563,7 +1517,7 @@ class PaperInfo:
     """
 
     id: str
-    authors: Optional[List[str]]
+    authors: Optional[list[str]]
     published_at: Optional[datetime]
     title: Optional[str]
     summary: Optional[str]
@@ -1727,8 +1681,8 @@ class HfApi:
         token: Union[str, bool, None] = None,
         library_name: Optional[str] = None,
         library_version: Optional[str] = None,
-        user_agent: Union[Dict, str, None] = None,
-        headers: Optional[Dict[str, str]] = None,
+        user_agent: Union[dict, str, None] = None,
+        headers: Optional[dict[str, str]] = None,
     ) -> None:
         self.endpoint = endpoint if endpoint is not None else constants.ENDPOINT
         self.token = token
@@ -1779,7 +1733,7 @@ class HfApi:
         return self._thread_pool.submit(fn, *args, **kwargs)
 
     @validate_hf_hub_args
-    def whoami(self, token: Union[bool, str, None] = None) -> Dict:
+    def whoami(self, token: Union[bool, str, None] = None) -> dict:
         """
         Call HF API to know "whoami".
 
@@ -1798,7 +1752,7 @@ class HfApi:
         )
         try:
             hf_raise_for_status(r)
-        except HTTPError as e:
+        except HfHubHTTPError as e:
             if e.response.status_code == 401:
                 error_message = "Invalid user token."
                 # Check which token is the effective one and generate the error message accordingly
@@ -1811,48 +1765,11 @@ class HfApi:
                     )
                 elif effective_token == _get_token_from_file():
                     error_message += " The token stored is invalid. Please run `hf auth login` to update it."
-                raise HTTPError(error_message, request=e.request, response=e.response) from e
+                raise HfHubHTTPError(error_message, response=e.response) from e
             raise
         return r.json()
 
-    @_deprecate_method(
-        version="1.0",
-        message=(
-            "Permissions are more complex than when `get_token_permission` was first introduced. "
-            "OAuth and fine-grain tokens allows for more detailed permissions. "
-            "If you need to know the permissions associated with a token, please use `whoami` and check the `'auth'` key."
-        ),
-    )
-    def get_token_permission(
-        self, token: Union[bool, str, None] = None
-    ) -> Literal["read", "write", "fineGrained", None]:
-        """
-        Check if a given `token` is valid and return its permissions.
-
-        > [!WARNING]
-        > This method is deprecated and will be removed in version 1.0. Permissions are more complex than when
-        > `get_token_permission` was first introduced. OAuth and fine-grain tokens allows for more detailed permissions.
-        > If you need to know the permissions associated with a token, please use `whoami` and check the `'auth'` key.
-
-        For more details about tokens, please refer to https://huggingface.co/docs/hub/security-tokens#what-are-user-access-tokens.
-
-        Args:
-            token (`bool` or `str`, *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", "fineGrained", None]`: Permission granted by the token ("read" or "write"). Returns `None` if no
-            token passed, if token is invalid or if role is not returned by the server. This typically happens when the token is an OAuth token.
-        """
-        try:
-            return self.whoami(token=token)["auth"]["accessToken"]["role"]
-        except (LocalTokenNotFoundError, HTTPError, KeyError):
-            return None
-
-    def get_model_tags(self) -> Dict:
+    def get_model_tags(self) -> dict:
         """
         List all valid model tags as a nested namespace object
         """
@@ -1861,7 +1778,7 @@ class HfApi:
         hf_raise_for_status(r)
         return r.json()
 
-    def get_dataset_tags(self) -> Dict:
+    def get_dataset_tags(self) -> dict:
         """
         List all valid dataset tags as a nested namespace object.
         """
@@ -1870,9 +1787,6 @@ class HfApi:
         hf_raise_for_status(r)
         return r.json()
 
-    @_deprecate_arguments(
-        version="1.0", deprecated_args=["language", "library", "task", "tags"], custom_message="Use `filter` instead."
-    )
     @validate_hf_hub_args
     def list_models(
         self,
@@ -1880,30 +1794,25 @@ class HfApi:
         # Search-query parameter
         filter: Union[str, Iterable[str], None] = None,
         author: Optional[str] = None,
-        apps: Optional[Union[str, List[str]]] = None,
+        apps: Optional[Union[str, list[str]]] = None,
         gated: Optional[bool] = None,
         inference: Optional[Literal["warm"]] = None,
-        inference_provider: Optional[Union[Literal["all"], "PROVIDER_T", List["PROVIDER_T"]]] = None,
+        inference_provider: Optional[Union[Literal["all"], "PROVIDER_T", list["PROVIDER_T"]]] = None,
         model_name: Optional[str] = None,
-        trained_dataset: Optional[Union[str, List[str]]] = None,
+        trained_dataset: Optional[Union[str, list[str]]] = None,
         search: Optional[str] = None,
         pipeline_tag: Optional[str] = None,
-        emissions_thresholds: Optional[Tuple[float, float]] = None,
+        emissions_thresholds: Optional[tuple[float, float]] = None,
         # Sorting and pagination parameters
         sort: Union[Literal["last_modified"], str, None] = None,
         direction: Optional[Literal[-1]] = None,
         limit: Optional[int] = None,
         # Additional data to fetch
-        expand: Optional[List[ExpandModelProperty_T]] = None,
+        expand: Optional[list[ExpandModelProperty_T]] = None,
         full: Optional[bool] = None,
         cardData: bool = False,
         fetch_config: bool = False,
         token: Union[bool, str, None] = None,
-        # Deprecated arguments - use `filter` instead
-        language: Optional[Union[str, List[str]]] = None,
-        library: Optional[Union[str, List[str]]] = None,
-        tags: Optional[Union[str, List[str]]] = None,
-        task: Optional[Union[str, List[str]]] = None,
     ) -> Iterable[ModelInfo]:
         """
         List models hosted on the Huggingface Hub, given some filters.
@@ -1927,20 +1836,12 @@ class HfApi:
             inference_provider (`Literal["all"]` or `str`, *optional*):
                 A string to filter models on the Hub that are served by a specific provider.
                 Pass `"all"` to get all models served by at least one provider.
-            library (`str` or `List`, *optional*):
-                Deprecated. Pass a library name in `filter` to filter models by library.
-            language (`str` or `List`, *optional*):
-                Deprecated. Pass a language in `filter` to filter models by language.
             model_name (`str`, *optional*):
                 A string that contain complete or partial names for models on the
                 Hub, such as "bert" or "bert-base-cased"
-            task (`str` or `List`, *optional*):
-                Deprecated. Pass a task in `filter` to filter models by task.
             trained_dataset (`str` or `List`, *optional*):
                 A string tag or a list of string tags of the trained dataset for a
                 model on the Hub.
-            tags (`str` or `List`, *optional*):
-                Deprecated. Pass tags in `filter` to filter models by tags.
             search (`str`, *optional*):
                 A string that will be contained in the returned model ids.
             pipeline_tag (`str`, *optional*):
@@ -1957,10 +1858,10 @@ class HfApi:
             limit (`int`, *optional*):
                 The limit on the number of models fetched. Leaving this option
                 to `None` fetches all models.
-            expand (`List[ExpandModelProperty_T]`, *optional*):
+            expand (`list[ExpandModelProperty_T]`, *optional*):
                 List properties to return in the response. When used, only the properties in the list will be returned.
                 This parameter cannot be used if `full`, `cardData` or `fetch_config` are passed.
-                Possible values are `"author"`, `"cardData"`, `"config"`, `"createdAt"`, `"disabled"`, `"downloads"`, `"downloadsAllTime"`, `"gated"`, `"gguf"`, `"inference"`, `"inferenceProviderMapping"`, `"lastModified"`, `"library_name"`, `"likes"`, `"mask_token"`, `"model-index"`, `"pipeline_tag"`, `"private"`, `"safetensors"`, `"sha"`, `"siblings"`, `"spaces"`, `"tags"`, `"transformersInfo"`, `"trendingScore"`, `"widgetData"`, `"resourceGroup"` and `"xetEnabled"`.
+                Possible values are `"author"`, `"cardData"`, `"config"`, `"createdAt"`, `"disabled"`, `"downloads"`, `"downloadsAllTime"`, `"gated"`, `"gguf"`, `"inference"`, `"inferenceProviderMapping"`, `"lastModified"`, `"library_name"`, `"likes"`, `"mask_token"`, `"model-index"`, `"pipeline_tag"`, `"private"`, `"safetensors"`, `"sha"`, `"siblings"`, `"spaces"`, `"tags"`, `"transformersInfo"`, `"trendingScore"`, `"widgetData"`, and `"resourceGroup"`.
             full (`bool`, *optional*):
                 Whether to fetch all model data, including the `last_modified`,
                 the `sha`, the files and the `tags`. This is set to `True` by
@@ -2016,27 +1917,15 @@ class HfApi:
 
         path = f"{self.endpoint}/api/models"
         headers = self._build_hf_headers(token=token)
-        params: Dict[str, Any] = {}
+        params: dict[str, Any] = {}
 
         # Build the filter list
-        filter_list: List[str] = []
+        filter_list: list[str] = []
         if filter:
             filter_list.extend([filter] if isinstance(filter, str) else filter)
-        if library:
-            filter_list.extend([library] if isinstance(library, str) else library)
-        if task:
-            filter_list.extend([task] if isinstance(task, str) else task)
         if trained_dataset:
-            if isinstance(trained_dataset, str):
-                trained_dataset = [trained_dataset]
-            for dataset in trained_dataset:
-                if not dataset.startswith("dataset:"):
-                    dataset = f"dataset:{dataset}"
-                filter_list.append(dataset)
-        if language:
-            filter_list.extend([language] if isinstance(language, str) else language)
-        if tags:
-            filter_list.extend([tags] if isinstance(tags, str) else tags)
+            datasets = [trained_dataset] if isinstance(trained_dataset, str) else trained_dataset
+            filter_list.extend(f"dataset:{d}" if not d.startswith("dataset:") else d for d in datasets)
         if len(filter_list) > 0:
             params["filter"] = filter_list
 
@@ -2106,26 +1995,26 @@ class HfApi:
         # Search-query parameter
         filter: Union[str, Iterable[str], None] = None,
         author: Optional[str] = None,
-        benchmark: Optional[Union[str, List[str]]] = None,
+        benchmark: Optional[Union[str, list[str]]] = None,
         dataset_name: Optional[str] = None,
         gated: Optional[bool] = None,
-        language_creators: Optional[Union[str, List[str]]] = None,
-        language: Optional[Union[str, List[str]]] = None,
-        multilinguality: Optional[Union[str, List[str]]] = None,
-        size_categories: Optional[Union[str, List[str]]] = None,
-        task_categories: Optional[Union[str, List[str]]] = None,
-        task_ids: Optional[Union[str, List[str]]] = None,
+        language_creators: Optional[Union[str, list[str]]] = None,
+        language: Optional[Union[str, list[str]]] = None,
+        multilinguality: Optional[Union[str, list[str]]] = None,
+        size_categories: Optional[Union[str, list[str]]] = None,
+        task_categories: Optional[Union[str, list[str]]] = None,
+        task_ids: Optional[Union[str, list[str]]] = None,
         search: Optional[str] = None,
         # Sorting and pagination parameters
         sort: Optional[Union[Literal["last_modified"], str]] = None,
         direction: Optional[Literal[-1]] = None,
         limit: Optional[int] = None,
         # Additional data to fetch
-        expand: Optional[List[ExpandDatasetProperty_T]] = None,
+        expand: Optional[list[ExpandDatasetProperty_T]] = None,
         full: Optional[bool] = None,
         token: Union[bool, str, None] = None,
         # Deprecated arguments - use `filter` instead
-        tags: Optional[Union[str, List[str]]] = None,
+        tags: Optional[Union[str, list[str]]] = None,
     ) -> Iterable[DatasetInfo]:
         """
         List datasets hosted on the Huggingface Hub, given some filters.
@@ -2180,10 +2069,10 @@ class HfApi:
             limit (`int`, *optional*):
                 The limit on the number of datasets fetched. Leaving this option
                 to `None` fetches all datasets.
-            expand (`List[ExpandDatasetProperty_T]`, *optional*):
+            expand (`list[ExpandDatasetProperty_T]`, *optional*):
                 List properties to return in the response. When used, only the properties in the list will be returned.
                 This parameter cannot be used if `full` is passed.
-                Possible values are `"author"`, `"cardData"`, `"citation"`, `"createdAt"`, `"disabled"`, `"description"`, `"downloads"`, `"downloadsAllTime"`, `"gated"`, `"lastModified"`, `"likes"`, `"paperswithcode_id"`, `"private"`, `"siblings"`, `"sha"`, `"tags"`, `"trendingScore"`, `"usedStorage"`, `"resourceGroup"` and `"xetEnabled"`.
+                Possible values are `"author"`, `"cardData"`, `"citation"`, `"createdAt"`, `"disabled"`, `"description"`, `"downloads"`, `"downloadsAllTime"`, `"gated"`, `"lastModified"`, `"likes"`, `"paperswithcode_id"`, `"private"`, `"siblings"`, `"sha"`, `"tags"`, `"trendingScore"`, `"usedStorage"`, and `"resourceGroup"`.
             full (`bool`, *optional*):
                 Whether to fetch all dataset data, including the `last_modified`,
                 the `card_data` and  the files. Can contain useful information such as the
@@ -2240,7 +2129,7 @@ class HfApi:
 
         path = f"{self.endpoint}/api/datasets"
         headers = self._build_hf_headers(token=token)
-        params: Dict[str, Any] = {}
+        params: dict[str, Any] = {}
 
         # Build `filter` list
         filter_list = []
@@ -2327,7 +2216,7 @@ class HfApi:
         direction: Optional[Literal[-1]] = None,
         limit: Optional[int] = None,
         # Additional data to fetch
-        expand: Optional[List[ExpandSpaceProperty_T]] = None,
+        expand: Optional[list[ExpandSpaceProperty_T]] = None,
         full: Optional[bool] = None,
         token: Union[bool, str, None] = None,
     ) -> Iterable[SpaceInfo]:
@@ -2358,10 +2247,10 @@ class HfApi:
             limit (`int`, *optional*):
                 The limit on the number of Spaces fetched. Leaving this option
                 to `None` fetches all Spaces.
-            expand (`List[ExpandSpaceProperty_T]`, *optional*):
+            expand (`list[ExpandSpaceProperty_T]`, *optional*):
                 List properties to return in the response. When used, only the properties in the list will be returned.
                 This parameter cannot be used if `full` is passed.
-                Possible values are `"author"`, `"cardData"`, `"datasets"`, `"disabled"`, `"lastModified"`, `"createdAt"`, `"likes"`, `"models"`, `"private"`, `"runtime"`, `"sdk"`, `"siblings"`, `"sha"`, `"subdomain"`, `"tags"`, `"trendingScore"`, `"usedStorage"`, `"resourceGroup"` and `"xetEnabled"`.
+                Possible values are `"author"`, `"cardData"`, `"datasets"`, `"disabled"`, `"lastModified"`, `"createdAt"`, `"likes"`, `"models"`, `"private"`, `"runtime"`, `"sdk"`, `"siblings"`, `"sha"`, `"subdomain"`, `"tags"`, `"trendingScore"`, `"usedStorage"`, and `"resourceGroup"`.
             full (`bool`, *optional*):
                 Whether to fetch all Spaces data, including the `last_modified`, `siblings`
                 and `card_data` fields.
@@ -2379,7 +2268,7 @@ class HfApi:
 
         path = f"{self.endpoint}/api/spaces"
         headers = self._build_hf_headers(token=token)
-        params: Dict[str, Any] = {}
+        params: dict[str, Any] = {}
         if filter is not None:
             params["filter"] = filter
         if author is not None:
@@ -2596,7 +2485,7 @@ class HfApi:
         timeout: Optional[float] = None,
         securityStatus: Optional[bool] = None,
         files_metadata: bool = False,
-        expand: Optional[List[ExpandModelProperty_T]] = None,
+        expand: Optional[list[ExpandModelProperty_T]] = None,
         token: Union[bool, str, None] = None,
     ) -> ModelInfo:
         """
@@ -2619,10 +2508,10 @@ class HfApi:
             files_metadata (`bool`, *optional*):
                 Whether or not to retrieve metadata for files in the repository
                 (size, LFS metadata, etc). Defaults to `False`.
-            expand (`List[ExpandModelProperty_T]`, *optional*):
+            expand (`list[ExpandModelProperty_T]`, *optional*):
                 List properties to return in the response. When used, only the properties in the list will be returned.
                 This parameter cannot be used if `securityStatus` or `files_metadata` are passed.
-                Possible values are `"author"`, `"baseModels"`, `"cardData"`, `"childrenModelCount"`, `"config"`, `"createdAt"`, `"disabled"`, `"downloads"`, `"downloadsAllTime"`, `"gated"`, `"gguf"`, `"inference"`, `"inferenceProviderMapping"`, `"lastModified"`, `"library_name"`, `"likes"`, `"mask_token"`, `"model-index"`, `"pipeline_tag"`, `"private"`, `"safetensors"`, `"sha"`, `"siblings"`, `"spaces"`, `"tags"`, `"transformersInfo"`, `"trendingScore"`, `"widgetData"`, `"usedStorage"`, `"resourceGroup"` and `"xetEnabled"`.
+                Possible values are `"author"`, `"baseModels"`, `"cardData"`, `"childrenModelCount"`, `"config"`, `"createdAt"`, `"disabled"`, `"downloads"`, `"downloadsAllTime"`, `"gated"`, `"gguf"`, `"inference"`, `"inferenceProviderMapping"`, `"lastModified"`, `"library_name"`, `"likes"`, `"mask_token"`, `"model-index"`, `"pipeline_tag"`, `"private"`, `"safetensors"`, `"sha"`, `"siblings"`, `"spaces"`, `"tags"`, `"transformersInfo"`, `"trendingScore"`, `"widgetData"`, `"usedStorage"`, and `"resourceGroup"`.
             token (`bool` or `str`, *optional*):
                 A valid user access token (string). Defaults to the locally saved
                 token, which is the recommended method for authentication (see
@@ -2650,7 +2539,7 @@ class HfApi:
             if revision is None
             else (f"{self.endpoint}/api/models/{repo_id}/revision/{quote(revision, safe='')}")
         )
-        params: Dict = {}
+        params: dict = {}
         if securityStatus:
             params["securityStatus"] = True
         if files_metadata:
@@ -2670,7 +2559,7 @@ class HfApi:
         revision: Optional[str] = None,
         timeout: Optional[float] = None,
         files_metadata: bool = False,
-        expand: Optional[List[ExpandDatasetProperty_T]] = None,
+        expand: Optional[list[ExpandDatasetProperty_T]] = None,
         token: Union[bool, str, None] = None,
     ) -> DatasetInfo:
         """
@@ -2690,10 +2579,10 @@ class HfApi:
             files_metadata (`bool`, *optional*):
                 Whether or not to retrieve metadata for files in the repository
                 (size, LFS metadata, etc). Defaults to `False`.
-            expand (`List[ExpandDatasetProperty_T]`, *optional*):
+            expand (`list[ExpandDatasetProperty_T]`, *optional*):
                 List properties to return in the response. When used, only the properties in the list will be returned.
                 This parameter cannot be used if `files_metadata` is passed.
-                Possible values are `"author"`, `"cardData"`, `"citation"`, `"createdAt"`, `"disabled"`, `"description"`, `"downloads"`, `"downloadsAllTime"`, `"gated"`, `"lastModified"`, `"likes"`, `"paperswithcode_id"`, `"private"`, `"siblings"`, `"sha"`, `"tags"`, `"trendingScore"`,`"usedStorage"`, `"resourceGroup"` and `"xetEnabled"`.
+                Possible values are `"author"`, `"cardData"`, `"citation"`, `"createdAt"`, `"disabled"`, `"description"`, `"downloads"`, `"downloadsAllTime"`, `"gated"`, `"lastModified"`, `"likes"`, `"paperswithcode_id"`, `"private"`, `"siblings"`, `"sha"`, `"tags"`, `"trendingScore"`,`"usedStorage"`, and `"resourceGroup"`.
             token (`bool` or `str`, *optional*):
                 A valid user access token (string). Defaults to the locally saved
                 token, which is the recommended method for authentication (see
@@ -2721,7 +2610,7 @@ class HfApi:
             if revision is None
             else (f"{self.endpoint}/api/datasets/{repo_id}/revision/{quote(revision, safe='')}")
         )
-        params: Dict = {}
+        params: dict = {}
         if files_metadata:
             params["blobs"] = True
         if expand:
@@ -2740,7 +2629,7 @@ class HfApi:
         revision: Optional[str] = None,
         timeout: Optional[float] = None,
         files_metadata: bool = False,
-        expand: Optional[List[ExpandSpaceProperty_T]] = None,
+        expand: Optional[list[ExpandSpaceProperty_T]] = None,
         token: Union[bool, str, None] = None,
     ) -> SpaceInfo:
         """
@@ -2760,10 +2649,10 @@ class HfApi:
             files_metadata (`bool`, *optional*):
                 Whether or not to retrieve metadata for files in the repository
                 (size, LFS metadata, etc). Defaults to `False`.
-            expand (`List[ExpandSpaceProperty_T]`, *optional*):
+            expand (`list[ExpandSpaceProperty_T]`, *optional*):
                 List properties to return in the response. When used, only the properties in the list will be returned.
                 This parameter cannot be used if `full` is passed.
-                Possible values are `"author"`, `"cardData"`, `"createdAt"`, `"datasets"`, `"disabled"`, `"lastModified"`, `"likes"`, `"models"`, `"private"`, `"runtime"`, `"sdk"`, `"siblings"`, `"sha"`, `"subdomain"`, `"tags"`, `"trendingScore"`, `"usedStorage"`, `"resourceGroup"` and `"xetEnabled"`.
+                Possible values are `"author"`, `"cardData"`, `"createdAt"`, `"datasets"`, `"disabled"`, `"lastModified"`, `"likes"`, `"models"`, `"private"`, `"runtime"`, `"sdk"`, `"siblings"`, `"sha"`, `"subdomain"`, `"tags"`, `"trendingScore"`, `"usedStorage"`, and `"resourceGroup"`.
             token (`bool` or `str`, *optional*):
                 A valid user access token (string). Defaults to the locally saved
                 token, which is the recommended method for authentication (see
@@ -2791,7 +2680,7 @@ class HfApi:
             if revision is None
             else (f"{self.endpoint}/api/spaces/{repo_id}/revision/{quote(revision, safe='')}")
         )
-        params: Dict = {}
+        params: dict = {}
         if files_metadata:
             params["blobs"] = True
         if expand:
@@ -3019,7 +2908,7 @@ class HfApi:
             return True
         except GatedRepoError:  # raise specifically on gated repo
             raise
-        except (RepositoryNotFoundError, EntryNotFoundError, RevisionNotFoundError):
+        except (RepositoryNotFoundError, RemoteEntryNotFoundError, RevisionNotFoundError):
             return False
 
     @validate_hf_hub_args
@@ -3030,7 +2919,7 @@ class HfApi:
         revision: Optional[str] = None,
         repo_type: Optional[str] = None,
         token: Union[str, bool, None] = None,
-    ) -> List[str]:
+    ) -> list[str]:
         """
         Get the list of files in a given repo.
 
@@ -3049,7 +2938,7 @@ class HfApi:
                 To disable authentication, pass `False`.
 
         Returns:
-            `List[str]`: the list of files in a given repository.
+            `list[str]`: the list of files in a given repository.
         """
         return [
             f.rfilename
@@ -3109,7 +2998,7 @@ class HfApi:
                 does not exist.
             [`~utils.RevisionNotFoundError`]:
                 If revision is not found (error 404) on the repo.
-            [`~utils.EntryNotFoundError`]:
+            [`~utils.RemoteEntryNotFoundError`]:
                 If the tree (folder) does not exist (error 404) on the repo.
 
         Examples:
@@ -3251,7 +3140,7 @@ class HfApi:
         hf_raise_for_status(response)
         data = response.json()
 
-        def _format_as_git_ref_info(item: Dict) -> GitRefInfo:
+        def _format_as_git_ref_info(item: dict) -> GitRefInfo:
             return GitRefInfo(name=item["name"], ref=item["ref"], target_commit=item["targetCommit"])
 
         return GitRefs(
@@ -3272,7 +3161,7 @@ class HfApi:
         token: Union[bool, str, None] = None,
         revision: Optional[str] = None,
         formatted: bool = False,
-    ) -> List[GitCommitInfo]:
+    ) -> list[GitCommitInfo]:
         """
         Get the list of commits of a given revision for a repo on the Hub.
 
@@ -3319,7 +3208,7 @@ class HfApi:
         ```
 
         Returns:
-            List[[`GitCommitInfo`]]: list of objects containing information about the commits for a repo on the Hub.
+            list[[`GitCommitInfo`]]: list of objects containing information about the commits for a repo on the Hub.
 
         Raises:
             [`~utils.RepositoryNotFoundError`]:
@@ -3353,20 +3242,20 @@ class HfApi:
     def get_paths_info(
         self,
         repo_id: str,
-        paths: Union[List[str], str],
+        paths: Union[list[str], str],
         *,
         expand: bool = False,
         revision: Optional[str] = None,
         repo_type: Optional[str] = None,
         token: Union[str, bool, None] = None,
-    ) -> List[Union[RepoFile, RepoFolder]]:
+    ) -> list[Union[RepoFile, RepoFolder]]:
         """
         Get information about a repo's paths.
 
         Args:
             repo_id (`str`):
                 A namespace (user or an organization) and a repo name separated by a `/`.
-            paths (`Union[List[str], str]`, *optional*):
+            paths (`Union[list[str], str]`, *optional*):
                 The paths to get information about. If a path do not exist, it is ignored without raising
                 an exception.
             expand (`bool`, *optional*, defaults to `False`):
@@ -3386,7 +3275,7 @@ class HfApi:
                 To disable authentication, pass `False`.
 
         Returns:
-            `List[Union[RepoFile, RepoFolder]]`:
+            `list[Union[RepoFile, RepoFolder]]`:
                 The information about the paths, as a list of [`RepoFile`] and [`RepoFolder`] objects.
 
         Raises:
@@ -3642,8 +3531,8 @@ class HfApi:
         space_hardware: Optional[SpaceHardware] = None,
         space_storage: Optional[SpaceStorage] = None,
         space_sleep_time: Optional[int] = None,
-        space_secrets: Optional[List[Dict[str, str]]] = None,
-        space_variables: Optional[List[Dict[str, str]]] = None,
+        space_secrets: Optional[list[dict[str, str]]] = None,
+        space_variables: Optional[list[dict[str, str]]] = None,
     ) -> RepoUrl:
         """Create an empty repo on the HuggingFace Hub.
 
@@ -3680,10 +3569,10 @@ class HfApi:
                 your Space to sleep (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.
-            space_secrets (`List[Dict[str, str]]`, *optional*):
+            space_secrets (`list[dict[str, str]]`, *optional*):
                 A list of secret keys to set in your Space. Each item is in the form `{"key": ..., "value": ..., "description": ...}` where description is optional.
                 For more details, see https://huggingface.co/docs/hub/spaces-overview#managing-secrets.
-            space_variables (`List[Dict[str, str]]`, *optional*):
+            space_variables (`list[dict[str, str]]`, *optional*):
                 A list of public environment variables to set in your Space. Each item is in the form `{"key": ..., "value": ..., "description": ...}` where description is optional.
                 For more details, see https://huggingface.co/docs/hub/spaces-overview#managing-secrets-and-environment-variables.
 
@@ -3698,7 +3587,7 @@ class HfApi:
         if repo_type not in constants.REPO_TYPES:
             raise ValueError("Invalid repo type")
 
-        json: Dict[str, Any] = {"name": name, "organization": organization}
+        json: dict[str, Any] = {"name": name, "organization": organization}
         if private is not None:
             json["private"] = private
         if repo_type is not None:
@@ -3734,11 +3623,6 @@ class HfApi:
             if provided_space_args:
                 warnings.warn(f"Ignoring provided {', '.join(provided_space_args)} because repo_type is not 'space'.")
 
-        if getattr(self, "_lfsmultipartthresh", None):
-            # Testing purposes only.
-            # See https://github.com/huggingface/huggingface_hub/pull/733/files#r820604472
-            json["lfsmultipartthresh"] = self._lfsmultipartthresh  # type: ignore
-
         if resource_group_id is not None:
             json["resourceGroupId"] = resource_group_id
 
@@ -3758,7 +3642,7 @@ class HfApi:
 
         try:
             hf_raise_for_status(r)
-        except HTTPError as err:
+        except HfHubHTTPError as err:
             if exist_ok and err.response.status_code == 409:
                 # Repo already exists and `exist_ok=True`
                 pass
@@ -3820,65 +3704,13 @@ class HfApi:
             json["type"] = repo_type
 
         headers = self._build_hf_headers(token=token)
-        r = get_session().delete(path, headers=headers, json=json)
+        r = get_session().request("DELETE", path, headers=headers, json=json)
         try:
             hf_raise_for_status(r)
         except RepositoryNotFoundError:
             if not missing_ok:
                 raise
 
-    @_deprecate_method(version="0.32", message="Please use `update_repo_settings` instead.")
-    @validate_hf_hub_args
-    def update_repo_visibility(
-        self,
-        repo_id: str,
-        private: bool = False,
-        *,
-        token: Union[str, bool, None] = None,
-        repo_type: Optional[str] = None,
-    ) -> Dict[str, bool]:
-        """Update the visibility setting of a repository.
-
-        Deprecated. Use `update_repo_settings` instead.
-
-        Args:
-            repo_id (`str`, *optional*):
-                A namespace (user or an organization) and a repo name separated by a `/`.
-            private (`bool`, *optional*, defaults to `False`):
-                Whether the repository should be private.
-            token (`bool` or `str`, *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
-                `None`.
-
-        Returns:
-            The HTTP response in json.
-
-        > [!TIP]
-        > Raises the following errors:
-        >
-        >     - [`~utils.RepositoryNotFoundError`]
-        >       If the repository to download from cannot be found. This may be because it doesn't exist,
-        >       or because it is set to `private` and you do not have access.
-        """
-        if repo_type not in constants.REPO_TYPES:
-            raise ValueError(f"Invalid repo type, must be one of {constants.REPO_TYPES}")
-        if repo_type is None:
-            repo_type = constants.REPO_TYPE_MODEL  # default repo type
-
-        r = get_session().put(
-            url=f"{self.endpoint}/api/{repo_type}s/{repo_id}/settings",
-            headers=self._build_hf_headers(token=token),
-            json={"private": private},
-        )
-        hf_raise_for_status(r)
-        return r.json()
-
     @validate_hf_hub_args
     def update_repo_settings(
         self,
@@ -3888,7 +3720,6 @@ class HfApi:
         private: Optional[bool] = None,
         token: Union[str, bool, None] = None,
         repo_type: Optional[str] = None,
-        xet_enabled: Optional[bool] = None,
     ) -> None:
         """
         Update the settings of a repository, including gated access and visibility.
@@ -3914,8 +3745,6 @@ class HfApi:
             repo_type (`str`, *optional*):
                 The type of the repository to update settings from (`"model"`, `"dataset"` or `"space"`).
                 Defaults to `"model"`.
-            xet_enabled (`bool`, *optional*):
-                Whether the repository should be enabled for Xet Storage.
         Raises:
             [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
                 If gated is not one of "auto", "manual", or False.
@@ -3934,7 +3763,7 @@ class HfApi:
             repo_type = constants.REPO_TYPE_MODEL  # default repo type
 
         # Prepare the JSON payload for the PUT request
-        payload: Dict = {}
+        payload: dict = {}
 
         if gated is not None:
             if gated not in ["auto", "manual", False]:
@@ -3944,9 +3773,6 @@ class HfApi:
         if private is not None:
             payload["private"] = private
 
-        if xet_enabled is not None:
-            payload["xetEnabled"] = xet_enabled
-
         if len(payload) == 0:
             raise ValueError("At least one setting must be updated.")
 
@@ -4317,12 +4143,12 @@ class HfApi:
         params = {"create_pr": "1"} if create_pr else None
 
         try:
-            commit_resp = get_session().post(url=commit_url, headers=headers, data=data, params=params)
+            commit_resp = get_session().post(url=commit_url, headers=headers, content=data, params=params)
             hf_raise_for_status(commit_resp, endpoint_name="commit")
         except RepositoryNotFoundError as e:
             e.append_to_message(_CREATE_COMMIT_NO_REPO_ERROR_MESSAGE)
             raise
-        except EntryNotFoundError as e:
+        except RemoteEntryNotFoundError as e:
             if nb_deletions > 0 and "A file with this name doesn't exist" in str(e):
                 e.append_to_message(
                     "\nMake sure to differentiate file and folder paths in delete"
@@ -4633,7 +4459,6 @@ class HfApi:
         ...         repo_type="dataset",
         ...         token="my_token",
         ...     )
-        "https://huggingface.co/datasets/username/my-dataset/blob/main/remote/file/path.h5"
 
         >>> upload_file(
         ...     path_or_fileobj=".\\\\local\\\\file\\\\path",
@@ -4641,7 +4466,6 @@ class HfApi:
         ...     repo_id="username/my-model",
         ...     token="my_token",
         ... )
-        "https://huggingface.co/username/my-model/blob/main/remote/file/path.h5"
 
         >>> upload_file(
         ...     path_or_fileobj=".\\\\local\\\\file\\\\path",
@@ -4650,7 +4474,6 @@ class HfApi:
         ...     token="my_token",
         ...     create_pr=True,
         ... )
-        "https://huggingface.co/username/my-model/blob/refs%2Fpr%2F1/remote/file/path.h5"
         ```
         """
         if repo_type not in constants.REPO_TYPES:
@@ -4664,7 +4487,7 @@ class HfApi:
             path_in_repo=path_in_repo,
         )
 
-        commit_info = self.create_commit(
+        return self.create_commit(
             repo_id=repo_id,
             repo_type=repo_type,
             operations=[operation],
@@ -4676,23 +4499,6 @@ class HfApi:
             parent_commit=parent_commit,
         )
 
-        if commit_info.pr_url is not None:
-            revision = quote(_parse_revision_from_pr_url(commit_info.pr_url), safe="")
-        if repo_type in constants.REPO_TYPES_URL_PREFIXES:
-            repo_id = constants.REPO_TYPES_URL_PREFIXES[repo_type] + repo_id
-        revision = revision if revision is not None else constants.DEFAULT_REVISION
-
-        return CommitInfo(
-            commit_url=commit_info.commit_url,
-            commit_message=commit_info.commit_message,
-            commit_description=commit_info.commit_description,
-            oid=commit_info.oid,
-            pr_url=commit_info.pr_url,
-            # Similar to `hf_hub_url` but it's "blob" instead of "resolve"
-            # TODO: remove this in v1.0
-            _url=f"{self.endpoint}/{repo_id}/blob/{revision}/{path_in_repo}",
-        )
-
     @overload
     def upload_folder(  # type: ignore
         self,
@@ -4707,9 +4513,9 @@ class HfApi:
         revision: Optional[str] = None,
         create_pr: Optional[bool] = None,
         parent_commit: Optional[str] = None,
-        allow_patterns: Optional[Union[List[str], str]] = None,
-        ignore_patterns: Optional[Union[List[str], str]] = None,
-        delete_patterns: Optional[Union[List[str], str]] = None,
+        allow_patterns: Optional[Union[list[str], str]] = None,
+        ignore_patterns: Optional[Union[list[str], str]] = None,
+        delete_patterns: Optional[Union[list[str], str]] = None,
         run_as_future: Literal[False] = ...,
     ) -> CommitInfo: ...
 
@@ -4727,9 +4533,9 @@ class HfApi:
         revision: Optional[str] = None,
         create_pr: Optional[bool] = None,
         parent_commit: Optional[str] = None,
-        allow_patterns: Optional[Union[List[str], str]] = None,
-        ignore_patterns: Optional[Union[List[str], str]] = None,
-        delete_patterns: Optional[Union[List[str], str]] = None,
+        allow_patterns: Optional[Union[list[str], str]] = None,
+        ignore_patterns: Optional[Union[list[str], str]] = None,
+        delete_patterns: Optional[Union[list[str], str]] = None,
         run_as_future: Literal[True] = ...,
     ) -> Future[CommitInfo]: ...
 
@@ -4748,9 +4554,9 @@ class HfApi:
         revision: Optional[str] = None,
         create_pr: Optional[bool] = None,
         parent_commit: Optional[str] = None,
-        allow_patterns: Optional[Union[List[str], str]] = None,
-        ignore_patterns: Optional[Union[List[str], str]] = None,
-        delete_patterns: Optional[Union[List[str], str]] = None,
+        allow_patterns: Optional[Union[list[str], str]] = None,
+        ignore_patterns: Optional[Union[list[str], str]] = None,
+        delete_patterns: Optional[Union[list[str], str]] = None,
         run_as_future: bool = False,
     ) -> Union[CommitInfo, Future[CommitInfo]]:
         """
@@ -4812,11 +4618,11 @@ class HfApi:
                 If specified and `create_pr` is `True`, the pull request will be created from `parent_commit`.
                 Specifying `parent_commit` ensures the repo has not changed before committing the changes, and can be
                 especially useful if the repo is updated / committed to concurrently.
-            allow_patterns (`List[str]` or `str`, *optional*):
+            allow_patterns (`list[str]` or `str`, *optional*):
                 If provided, only files matching at least one pattern are uploaded.
-            ignore_patterns (`List[str]` or `str`, *optional*):
+            ignore_patterns (`list[str]` or `str`, *optional*):
                 If provided, files matching any of the patterns are not uploaded.
-            delete_patterns (`List[str]` or `str`, *optional*):
+            delete_patterns (`list[str]` or `str`, *optional*):
                 If provided, remote files matching any of the patterns will be deleted from the repo while committing
                 new files. This is useful if you don't know which files have already been uploaded.
                 Note: to avoid discrepancies the `.gitattributes` file is not deleted even if it matches the pattern.
@@ -4859,7 +4665,6 @@ class HfApi:
         ...     token="my_token",
         ...     ignore_patterns="**/logs/*.txt",
         ... )
-        # "https://huggingface.co/datasets/username/my-dataset/tree/main/remote/experiment/checkpoints"
 
         # Upload checkpoints folder including logs while deleting existing logs from the repo
         # Useful if you don't know exactly which log files have already being pushed
@@ -4871,7 +4676,6 @@ class HfApi:
         ...     token="my_token",
         ...     delete_patterns="**/logs/*.txt",
         ... )
-        "https://huggingface.co/datasets/username/my-dataset/tree/main/remote/experiment/checkpoints"
 
         # Upload checkpoints folder while creating a PR
         >>> upload_folder(
@@ -4882,8 +4686,6 @@ class HfApi:
         ...     token="my_token",
         ...     create_pr=True,
         ... )
-        "https://huggingface.co/datasets/username/my-dataset/tree/refs%2Fpr%2F1/remote/experiment/checkpoints"
-
         ```
         """
         if repo_type not in constants.REPO_TYPES:
@@ -4927,7 +4729,7 @@ class HfApi:
 
         commit_message = commit_message or "Upload folder using huggingface_hub"
 
-        commit_info = self.create_commit(
+        return self.create_commit(
             repo_type=repo_type,
             repo_id=repo_id,
             operations=commit_operations,
@@ -4939,24 +4741,6 @@ class HfApi:
             parent_commit=parent_commit,
         )
 
-        # Create url to uploaded folder (for legacy return value)
-        if create_pr and commit_info.pr_url is not None:
-            revision = quote(_parse_revision_from_pr_url(commit_info.pr_url), safe="")
-        if repo_type in constants.REPO_TYPES_URL_PREFIXES:
-            repo_id = constants.REPO_TYPES_URL_PREFIXES[repo_type] + repo_id
-        revision = revision if revision is not None else constants.DEFAULT_REVISION
-
-        return CommitInfo(
-            commit_url=commit_info.commit_url,
-            commit_message=commit_info.commit_message,
-            commit_description=commit_info.commit_description,
-            oid=commit_info.oid,
-            pr_url=commit_info.pr_url,
-            # Similar to `hf_hub_url` but it's "tree" instead of "resolve"
-            # TODO: remove this in v1.0
-            _url=f"{self.endpoint}/{repo_id}/tree/{revision}/{path_in_repo}",
-        )
-
     @validate_hf_hub_args
     def delete_file(
         self,
@@ -5048,7 +4832,7 @@ class HfApi:
     def delete_files(
         self,
         repo_id: str,
-        delete_patterns: List[str],
+        delete_patterns: list[str],
         *,
         token: Union[bool, str, None] = None,
         repo_type: Optional[str] = None,
@@ -5068,7 +4852,7 @@ class HfApi:
             repo_id (`str`):
                 The repository from which the folder will be deleted, for example:
                 `"username/custom_transformers"`
-            delete_patterns (`List[str]`):
+            delete_patterns (`list[str]`):
                 List of files or folders to delete. Each string can either be
                 a file path, a folder path or a Unix shell-style wildcard.
                 E.g. `["file.txt", "folder/", "data/*.parquet"]`
@@ -5196,8 +4980,8 @@ class HfApi:
         repo_type: str,  # Repo type is required!
         revision: Optional[str] = None,
         private: Optional[bool] = None,
-        allow_patterns: Optional[Union[List[str], str]] = None,
-        ignore_patterns: Optional[Union[List[str], str]] = None,
+        allow_patterns: Optional[Union[list[str], str]] = None,
+        ignore_patterns: Optional[Union[list[str], str]] = None,
         num_workers: Optional[int] = None,
         print_report: bool = True,
         print_report_every: int = 60,
@@ -5225,9 +5009,9 @@ class HfApi:
             private (`bool`, `optional`):
                 Whether the repository should be private.
                 If `None` (default), the repo will be public unless the organization's default is private.
-            allow_patterns (`List[str]` or `str`, *optional*):
+            allow_patterns (`list[str]` or `str`, *optional*):
                 If provided, only files matching at least one pattern are uploaded.
-            ignore_patterns (`List[str]` or `str`, *optional*):
+            ignore_patterns (`list[str]` or `str`, *optional*):
                 If provided, files matching any of the patterns are not uploaded.
             num_workers (`int`, *optional*):
                 Number of workers to start. Defaults to `os.cpu_count() - 2` (minimum 2).
@@ -5280,14 +5064,13 @@ class HfApi:
             4. Pre-upload LFS file if at least 1 file and no worker is pre-uploading.
             5. Hash file if at least 1 file and no worker is hashing.
             6. Get upload mode if at least 1 file and no worker is getting upload mode.
-            7. Pre-upload LFS file if at least 1 file (exception: if hf_transfer is enabled, only 1 worker can preupload LFS at a time).
+            7. Pre-upload LFS file if at least 1 file.
             8. Hash file if at least 1 file to hash.
             9. Get upload mode if at least 1 file to get upload mode.
             10. Commit if at least 1 file to commit and at least 1 min since last commit attempt.
             11. Commit if at least 1 file to commit and all other queues are empty.
 
         Special rules:
-            - If `hf_transfer` is enabled, only 1 LFS uploader at a time. Otherwise the CPU would be bloated by `hf_transfer`.
             - Only one worker can commit at a time.
             - If no tasks are available, the worker waits for 10 seconds before checking again.
         """
@@ -5311,7 +5094,6 @@ class HfApi:
         *,
         url: str,
         token: Union[bool, str, None] = None,
-        proxies: Optional[Dict] = None,
         timeout: Optional[float] = constants.DEFAULT_REQUEST_TIMEOUT,
     ) -> HfFileMetadata:
         """Fetch metadata of a file versioned on the Hub for a given url.
@@ -5324,8 +5106,6 @@ class HfApi:
                 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):
                 How many seconds to wait for the server to send metadata before giving up.
 
@@ -5339,7 +5119,6 @@ class HfApi:
         return get_hf_file_metadata(
             url=url,
             token=token,
-            proxies=proxies,
             timeout=timeout,
             library_name=self.library_name,
             library_version=self.library_version,
@@ -5347,6 +5126,42 @@ class HfApi:
             endpoint=self.endpoint,
         )
 
+    @overload
+    def hf_hub_download(
+        self,
+        repo_id: str,
+        filename: str,
+        *,
+        subfolder: Optional[str] = None,
+        repo_type: Optional[str] = None,
+        revision: Optional[str] = None,
+        cache_dir: Union[str, Path, None] = None,
+        local_dir: Union[str, Path, None] = None,
+        force_download: bool = False,
+        etag_timeout: float = constants.DEFAULT_ETAG_TIMEOUT,
+        token: Union[bool, str, None] = None,
+        local_files_only: bool = False,
+        dry_run: Literal[False] = False,
+    ) -> str: ...
+
+    @overload
+    def hf_hub_download(
+        self,
+        repo_id: str,
+        filename: str,
+        *,
+        subfolder: Optional[str] = None,
+        repo_type: Optional[str] = None,
+        revision: Optional[str] = None,
+        cache_dir: Union[str, Path, None] = None,
+        local_dir: Union[str, Path, None] = None,
+        force_download: bool = False,
+        etag_timeout: float = constants.DEFAULT_ETAG_TIMEOUT,
+        token: Union[bool, str, None] = None,
+        local_files_only: bool = False,
+        dry_run: Literal[True],
+    ) -> DryRunFileInfo: ...
+
     @validate_hf_hub_args
     def hf_hub_download(
         self,
@@ -5359,15 +5174,11 @@ class HfApi:
         cache_dir: Union[str, Path, None] = None,
         local_dir: Union[str, Path, None] = None,
         force_download: bool = False,
-        proxies: Optional[Dict] = None,
         etag_timeout: float = constants.DEFAULT_ETAG_TIMEOUT,
         token: Union[bool, str, None] = None,
         local_files_only: bool = False,
-        # Deprecated args
-        resume_download: Optional[bool] = None,
-        force_filename: Optional[str] = None,
-        local_dir_use_symlinks: Union[bool, Literal["auto"]] = "auto",
-    ) -> str:
+        dry_run: bool = False,
+    ) -> Union[str, DryRunFileInfo]:
         """Download a given file if it's not already present in the local cache.
 
         The new cache file layout looks like this:
@@ -5423,12 +5234,9 @@ class HfApi:
             force_download (`bool`, *optional*, defaults to `False`):
                 Whether the file should be downloaded even if it already exists in
                 the local cache.
-            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`.
+                data before giving up which is passed to `httpx.request`.
             token (`bool` or `str`, *optional*):
                 A valid user access token (string). Defaults to the locally saved
                 token, which is the recommended method for authentication (see
@@ -5437,9 +5245,14 @@ class HfApi:
             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.
+            dry_run (`bool`, *optional*, defaults to `False`):
+                If `True`, perform a dry run without actually downloading the file. Returns a
+                [`DryRunFileInfo`] object containing information about what would be downloaded.
 
         Returns:
-            `str`: Local path of file or if networking is off, last version of file cached on disk.
+            `str` or [`DryRunFileInfo`]:
+                - If `dry_run=False`: Local path of file or if networking is off, last version of file cached on disk.
+                - If `dry_run=True`: A [`DryRunFileInfo`] object containing download information.
 
         Raises:
             [`~utils.RepositoryNotFoundError`]
@@ -5447,7 +5260,7 @@ class HfApi:
                 or because it is set to `private` and you do not have access.
             [`~utils.RevisionNotFoundError`]
                 If the revision to download from cannot be found.
-            [`~utils.EntryNotFoundError`]
+            [`~utils.RemoteEntryNotFoundError`]
                 If the file to download cannot be found.
             [`~utils.LocalEntryNotFoundError`]
                 If network is disabled or unavailable and file is not found in cache.
@@ -5475,13 +5288,9 @@ class HfApi:
             library_version=self.library_version,
             cache_dir=cache_dir,
             local_dir=local_dir,
-            local_dir_use_symlinks=local_dir_use_symlinks,
             user_agent=self.user_agent,
             force_download=force_download,
-            force_filename=force_filename,
-            proxies=proxies,
             etag_timeout=etag_timeout,
-            resume_download=resume_download,
             token=token,
             headers=self.headers,
             local_files_only=local_files_only,
@@ -5496,18 +5305,14 @@ class HfApi:
         revision: Optional[str] = None,
         cache_dir: Union[str, Path, None] = None,
         local_dir: Union[str, Path, None] = None,
-        proxies: Optional[Dict] = None,
         etag_timeout: float = constants.DEFAULT_ETAG_TIMEOUT,
         force_download: bool = False,
         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,
+        allow_patterns: Optional[Union[list[str], str]] = None,
+        ignore_patterns: Optional[Union[list[str], str]] = None,
         max_workers: int = 8,
-        tqdm_class: Optional[Type[base_tqdm]] = None,
-        # Deprecated args
-        local_dir_use_symlinks: Union[bool, Literal["auto"]] = "auto",
-        resume_download: Optional[bool] = None,
+        tqdm_class: Optional[type[base_tqdm]] = None,
     ) -> str:
         """Download repo files.
 
@@ -5537,12 +5342,9 @@ class HfApi:
                 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.
-            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`.
+                data before giving up which is passed to `httpx.request`.
             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*):
@@ -5553,9 +5355,9 @@ class HfApi:
             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.
-            allow_patterns (`List[str]` or `str`, *optional*):
+            allow_patterns (`list[str]` or `str`, *optional*):
                 If provided, only files matching at least one pattern are downloaded.
-            ignore_patterns (`List[str]` or `str`, *optional*):
+            ignore_patterns (`list[str]` or `str`, *optional*):
                 If provided, files matching any of the patterns are not downloaded.
             max_workers (`int`, *optional*):
                 Number of concurrent threads to download files (1 thread = 1 file download).
@@ -5596,13 +5398,10 @@ class HfApi:
             endpoint=self.endpoint,
             cache_dir=cache_dir,
             local_dir=local_dir,
-            local_dir_use_symlinks=local_dir_use_symlinks,
             library_name=self.library_name,
             library_version=self.library_version,
             user_agent=self.user_agent,
-            proxies=proxies,
             etag_timeout=etag_timeout,
-            resume_download=resume_download,
             force_download=force_download,
             token=token,
             local_files_only=local_files_only,
@@ -6219,7 +6018,7 @@ class HfApi:
         headers = self._build_hf_headers(token=token)
         path = f"{self.endpoint}/api/{repo_type}s/{repo_id}/discussions"
 
-        params: Dict[str, Union[str, int]] = {}
+        params: dict[str, Union[str, int]] = {}
         if discussion_type is not None:
             params["type"] = discussion_type
         if discussion_status is not None:
@@ -6488,7 +6287,7 @@ class HfApi:
         body: Optional[dict] = None,
         token: Union[bool, str, None] = None,
         repo_type: Optional[str] = None,
-    ) -> requests.Response:
+    ) -> httpx.Response:
         """Internal utility to POST changes to a Discussion or Pull Request"""
         if not isinstance(discussion_num, int) or discussion_num <= 0:
             raise ValueError("Invalid discussion_num, must be a positive integer")
@@ -6501,7 +6300,7 @@ class HfApi:
         path = f"{self.endpoint}/api/{repo_id}/discussions/{discussion_num}/{resource}"
 
         headers = self._build_hf_headers(token=token)
-        resp = requests.post(path, headers=headers, json=body)
+        resp = get_session().post(path, headers=headers, json=body)
         hf_raise_for_status(resp)
         return resp
 
@@ -6710,7 +6509,7 @@ class HfApi:
         """
         if new_status not in ["open", "closed"]:
             raise ValueError("Invalid status, valid statuses are: 'open' and 'closed'")
-        body: Dict[str, str] = {"status": new_status}
+        body: dict[str, str] = {"status": new_status}
         if comment and comment.strip():
             body["comment"] = comment.strip()
         resp = self._post_discussion_changes(
@@ -6951,7 +6750,8 @@ class HfApi:
                 https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
                 To disable authentication, pass `False`.
         """
-        r = get_session().delete(
+        r = get_session().request(
+            "DELETE",
             f"{self.endpoint}/api/spaces/{repo_id}/secrets",
             headers=self._build_hf_headers(token=token),
             json={"key": key},
@@ -6959,7 +6759,7 @@ class HfApi:
         hf_raise_for_status(r)
 
     @validate_hf_hub_args
-    def get_space_variables(self, repo_id: str, *, token: Union[bool, str, None] = 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.
@@ -6990,7 +6790,7 @@ class HfApi:
         *,
         description: Optional[str] = None,
         token: Union[bool, str, None] = None,
-    ) -> Dict[str, SpaceVariable]:
+    ) -> dict[str, SpaceVariable]:
         """Adds or updates a variable in a Space.
 
         Variables allow to set environment variables to a Space without hardcoding them.
@@ -7025,7 +6825,7 @@ class HfApi:
     @validate_hf_hub_args
     def delete_space_variable(
         self, repo_id: str, key: str, *, token: Union[bool, str, None] = None
-    ) -> Dict[str, SpaceVariable]:
+    ) -> dict[str, SpaceVariable]:
         """Deletes a variable from a Space.
 
         Variables allow to set environment variables to a Space without hardcoding them.
@@ -7042,7 +6842,8 @@ class HfApi:
                 https://huggingface.co/docs/huggingface_hub/quick-start#authentication).
                 To disable authentication, pass `False`.
         """
-        r = get_session().delete(
+        r = get_session().request(
+            "DELETE",
             f"{self.endpoint}/api/spaces/{repo_id}/variables",
             headers=self._build_hf_headers(token=token),
             json={"key": key},
@@ -7110,7 +6911,7 @@ class HfApi:
                 " you want to set a custom sleep time, you need to upgrade to a paid Hardware.",
                 UserWarning,
             )
-        payload: Dict[str, Any] = {"flavor": hardware}
+        payload: dict[str, Any] = {"flavor": hardware}
         if sleep_time is not None:
             payload["sleepTimeSeconds"] = sleep_time
         r = get_session().post(
@@ -7266,8 +7067,8 @@ class HfApi:
         hardware: Optional[SpaceHardware] = None,
         storage: Optional[SpaceStorage] = None,
         sleep_time: Optional[int] = None,
-        secrets: Optional[List[Dict[str, str]]] = None,
-        variables: Optional[List[Dict[str, str]]] = None,
+        secrets: Optional[list[dict[str, str]]] = None,
+        variables: Optional[list[dict[str, str]]] = None,
     ) -> RepoUrl:
         """Duplicate a Space.
 
@@ -7298,10 +7099,10 @@ class HfApi:
                 your Space to sleep (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.
-            secrets (`List[Dict[str, str]]`, *optional*):
+            secrets (`list[dict[str, str]]`, *optional*):
                 A list of secret keys to set in your Space. Each item is in the form `{"key": ..., "value": ..., "description": ...}` where description is optional.
                 For more details, see https://huggingface.co/docs/hub/spaces-overview#managing-secrets.
-            variables (`List[Dict[str, str]]`, *optional*):
+            variables (`list[dict[str, str]]`, *optional*):
                 A list of public environment variables to set in your Space. Each item is in the form `{"key": ..., "value": ..., "description": ...}` where description is optional.
                 For more details, see https://huggingface.co/docs/hub/spaces-overview#managing-secrets-and-environment-variables.
 
@@ -7313,7 +7114,7 @@ class HfApi:
             [`~utils.RepositoryNotFoundError`]:
               If one of `from_id` or `to_id` cannot be found. This may be because it doesn't exist,
               or because it is set to `private` and you do not have access.
-            [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError):
+            [`HfHubHTTPError`]:
               If the HuggingFace API returned an error
 
         Example:
@@ -7341,7 +7142,7 @@ class HfApi:
         to_repo_name = parsed_to_id.repo_name if to_id is not None else RepoUrl(from_id).repo_name  # type: ignore
 
         # repository must be a valid repo_id (namespace/repo_name).
-        payload: Dict[str, Any] = {"repository": f"{to_namespace}/{to_repo_name}"}
+        payload: dict[str, Any] = {"repository": f"{to_namespace}/{to_repo_name}"}
 
         keys = ["private", "hardware", "storageTier", "sleepTimeSeconds", "secrets", "variables"]
         values = [private, hardware, storage, sleep_time, secrets, variables]
@@ -7363,7 +7164,7 @@ class HfApi:
 
         try:
             hf_raise_for_status(r)
-        except HTTPError as err:
+        except HfHubHTTPError as err:
             if exist_ok and err.response.status_code == 409:
                 # Repo already exists and `exist_ok=True`
                 pass
@@ -7399,7 +7200,7 @@ class HfApi:
         > It is not possible to decrease persistent storage after its granted. To do so, you must delete it
         > via [`delete_space_storage`].
         """
-        payload: Dict[str, SpaceStorage] = {"tier": storage}
+        payload: dict[str, SpaceStorage] = {"tier": storage}
         r = get_session().post(
             f"{self.endpoint}/api/spaces/{repo_id}/storage",
             headers=self._build_hf_headers(token=token),
@@ -7445,7 +7246,7 @@ class HfApi:
 
     def list_inference_endpoints(
         self, namespace: Optional[str] = None, *, token: Union[bool, str, None] = None
-    ) -> List[InferenceEndpoint]:
+    ) -> list[InferenceEndpoint]:
         """Lists all inference endpoints for the given namespace.
 
         Args:
@@ -7459,7 +7260,7 @@ class HfApi:
                 To disable authentication, pass `False`.
 
         Returns:
-            List[`InferenceEndpoint`]: A list of all inference endpoints for the given namespace.
+            list[`InferenceEndpoint`]: A list of all inference endpoints for the given namespace.
 
         Example:
         ```python
@@ -7474,7 +7275,7 @@ class HfApi:
             user = self.whoami(token=token)
 
             # List personal endpoints first
-            endpoints: List[InferenceEndpoint] = list_inference_endpoints(namespace=self._get_namespace(token=token))
+            endpoints: list[InferenceEndpoint] = list_inference_endpoints(namespace=self._get_namespace(token=token))
 
             # Then list endpoints for all orgs the user belongs to and ignore 401 errors (no billing or no access)
             for org in user.get("orgs", []):
@@ -7518,14 +7319,14 @@ class HfApi:
         scale_to_zero_timeout: Optional[int] = None,
         revision: Optional[str] = None,
         task: Optional[str] = None,
-        custom_image: Optional[Dict] = None,
-        env: Optional[Dict[str, str]] = None,
-        secrets: Optional[Dict[str, str]] = None,
+        custom_image: Optional[dict] = None,
+        env: Optional[dict[str, str]] = None,
+        secrets: Optional[dict[str, str]] = None,
         type: InferenceEndpointType = InferenceEndpointType.PROTECTED,
         domain: Optional[str] = None,
         path: Optional[str] = None,
         cache_http_responses: Optional[bool] = None,
-        tags: Optional[List[str]] = None,
+        tags: Optional[list[str]] = None,
         namespace: Optional[str] = None,
         token: Union[bool, str, None] = None,
     ) -> InferenceEndpoint:
@@ -7562,12 +7363,12 @@ class HfApi:
                 The specific model revision to deploy on the Inference Endpoint (e.g. `"6c0e6080953db56375760c0471a8c5f2929baf11"`).
             task (`str`, *optional*):
                 The task on which to deploy the model (e.g. `"text-classification"`).
-            custom_image (`Dict`, *optional*):
+            custom_image (`dict`, *optional*):
                 A custom Docker image to use for the Inference Endpoint. This is useful if you want to deploy an
                 Inference Endpoint running on the `text-generation-inference` (TGI) framework (see examples).
-            env (`Dict[str, str]`, *optional*):
+            env (`dict[str, str]`, *optional*):
                 Non-secret environment variables to inject in the container environment.
-            secrets (`Dict[str, str]`, *optional*):
+            secrets (`dict[str, str]`, *optional*):
                 Secret values to inject in the container environment.
             type ([`InferenceEndpointType]`, *optional*):
                 The type of the Inference Endpoint, which can be `"protected"` (default), `"public"` or `"private"`.
@@ -7577,7 +7378,7 @@ class HfApi:
                 The custom path to the deployed model, should start with a `/` (e.g. `"/models/google-bert/bert-base-uncased"`).
             cache_http_responses (`bool`, *optional*):
                 Whether to cache HTTP responses from the Inference Endpoint. Defaults to `False`.
-            tags (`List[str]`, *optional*):
+            tags (`list[str]`, *optional*):
                 A list of tags to associate with the Inference Endpoint.
             namespace (`str`, *optional*):
                 The namespace where the Inference Endpoint will be created. Defaults to the current user's namespace.
@@ -7680,7 +7481,7 @@ class HfApi:
         else:
             image = {"huggingface": {}}
 
-        payload: Dict = {
+        payload: dict = {
             "accountId": account_id,
             "compute": {
                 "accelerator": accelerator,
@@ -7766,7 +7567,7 @@ class HfApi:
         > if you have any suggestions or requests.
         """
         token = token or self.token or get_token()
-        payload: Dict = {
+        payload: dict = {
             "namespace": namespace or self._get_namespace(token=token),
             "repoId": repo_id,
         }
@@ -7784,7 +7585,7 @@ class HfApi:
 
     @experimental
     @validate_hf_hub_args
-    def list_inference_catalog(self, *, token: Union[bool, str, None] = None) -> List[str]:
+    def list_inference_catalog(self, *, token: Union[bool, str, None] = None) -> list[str]:
         """List models available in the Hugging Face Inference Catalog.
 
         The goal of the Inference Catalog is to provide a curated list of models that are optimized for inference
@@ -7875,15 +7676,15 @@ class HfApi:
         framework: Optional[str] = None,
         revision: Optional[str] = None,
         task: Optional[str] = None,
-        custom_image: Optional[Dict] = None,
-        env: Optional[Dict[str, str]] = None,
-        secrets: Optional[Dict[str, str]] = None,
+        custom_image: Optional[dict] = None,
+        env: Optional[dict[str, str]] = None,
+        secrets: Optional[dict[str, str]] = None,
         # Route update
         domain: Optional[str] = None,
         path: Optional[str] = None,
         # Other
         cache_http_responses: Optional[bool] = None,
-        tags: Optional[List[str]] = None,
+        tags: Optional[list[str]] = None,
         namespace: Optional[str] = None,
         token: Union[bool, str, None] = None,
     ) -> InferenceEndpoint:
@@ -7919,12 +7720,12 @@ class HfApi:
                 The specific model revision to deploy on the Inference Endpoint (e.g. `"6c0e6080953db56375760c0471a8c5f2929baf11"`).
             task (`str`, *optional*):
                 The task on which to deploy the model (e.g. `"text-classification"`).
-            custom_image (`Dict`, *optional*):
+            custom_image (`dict`, *optional*):
                 A custom Docker image to use for the Inference Endpoint. This is useful if you want to deploy an
                 Inference Endpoint running on the `text-generation-inference` (TGI) framework (see examples).
-            env (`Dict[str, str]`, *optional*):
+            env (`dict[str, str]`, *optional*):
                 Non-secret environment variables to inject in the container environment
-            secrets (`Dict[str, str]`, *optional*):
+            secrets (`dict[str, str]`, *optional*):
                 Secret values to inject in the container environment.
 
             domain (`str`, *optional*):
@@ -7934,7 +7735,7 @@ class HfApi:
 
             cache_http_responses (`bool`, *optional*):
                 Whether to cache HTTP responses from the Inference Endpoint.
-            tags (`List[str]`, *optional*):
+            tags (`list[str]`, *optional*):
                 A list of tags to associate with the Inference Endpoint.
 
             namespace (`str`, *optional*):
@@ -7951,7 +7752,7 @@ class HfApi:
         namespace = namespace or self._get_namespace(token=token)
 
         # Populate only the fields that are not None
-        payload: Dict = defaultdict(lambda: defaultdict(dict))
+        payload: dict = defaultdict(lambda: defaultdict(dict))
         if accelerator is not None:
             payload["compute"]["accelerator"] = accelerator
         if instance_size is not None:
@@ -8158,8 +7959,8 @@ class HfApi:
     def list_collections(
         self,
         *,
-        owner: Union[List[str], str, None] = None,
-        item: Union[List[str], str, None] = None,
+        owner: Union[list[str], str, None] = None,
+        item: Union[list[str], str, None] = None,
         sort: Optional[Literal["lastModified", "trending", "upvotes"]] = None,
         limit: Optional[int] = None,
         token: Union[bool, str, None] = None,
@@ -8171,9 +7972,9 @@ class HfApi:
         > from a collection, you must use [`get_collection`].
 
         Args:
-            owner (`List[str]` or `str`, *optional*):
+            owner (`list[str]` or `str`, *optional*):
                 Filter by owner's username.
-            item (`List[str]` or `str`, *optional*):
+            item (`list[str]` or `str`, *optional*):
                 Filter collections containing a particular items. Example: `"models/teknium/OpenHermes-2.5-Mistral-7B"`, `"datasets/squad"` or `"papers/2311.12983"`.
             sort (`Literal["lastModified", "trending", "upvotes"]`, *optional*):
                 Sort collections by last modified, trending or upvotes.
@@ -8191,7 +7992,7 @@ class HfApi:
         # Construct the API endpoint
         path = f"{self.endpoint}/api/collections"
         headers = self._build_hf_headers(token=token)
-        params: Dict = {}
+        params: dict = {}
         if owner is not None:
             params.update({"owner": owner})
         if item is not None:
@@ -8308,7 +8109,7 @@ class HfApi:
         )
         try:
             hf_raise_for_status(r)
-        except HTTPError as err:
+        except HfHubHTTPError as err:
             if exists_ok and err.response.status_code == 409:
                 # Collection already exists and `exists_ok=True`
                 slug = r.json()["slug"]
@@ -8416,7 +8217,7 @@ class HfApi:
         )
         try:
             hf_raise_for_status(r)
-        except HTTPError as err:
+        except HfHubHTTPError as err:
             if missing_ok and err.response.status_code == 404:
                 # Collection doesn't exists and `missing_ok=True`
                 return
@@ -8456,12 +8257,12 @@ class HfApi:
         Returns: [`Collection`]
 
         Raises:
-            [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError):
+            [`HfHubHTTPError`]:
                 HTTP 403 if you only have read-only access to the repo. This can be the case if you don't have `write`
                 or `admin` role in the organization the repo belongs to or if you passed a `read` token.
-            [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError):
+            [`HfHubHTTPError`]:
                 HTTP 404 if the item you try to add to the collection does not exist on the Hub.
-            [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError):
+            [`HfHubHTTPError`]:
                 HTTP 409 if the item you try to add to the collection is already in the collection (and exists_ok=False)
 
         Example:
@@ -8487,7 +8288,7 @@ class HfApi:
         (...)
         ```
         """
-        payload: Dict[str, Any] = {"item": {"id": item_id, "type": item_type}}
+        payload: dict[str, Any] = {"item": {"id": item_id, "type": item_type}}
         if note is not None:
             payload["note"] = note
         r = get_session().post(
@@ -8497,7 +8298,7 @@ class HfApi:
         )
         try:
             hf_raise_for_status(r)
-        except HTTPError as err:
+        except HfHubHTTPError as err:
             if exists_ok and err.response.status_code == 409:
                 # Item already exists and `exists_ok=True`
                 return self.get_collection(collection_slug, token=token)
@@ -8603,7 +8404,7 @@ class HfApi:
         )
         try:
             hf_raise_for_status(r)
-        except HTTPError as err:
+        except HfHubHTTPError as err:
             if missing_ok and err.response.status_code == 404:
                 # Item already deleted and `missing_ok=True`
                 return
@@ -8617,7 +8418,7 @@ class HfApi:
     @validate_hf_hub_args
     def list_pending_access_requests(
         self, repo_id: str, *, repo_type: Optional[str] = None, token: Union[bool, str, None] = None
-    ) -> List[AccessRequest]:
+    ) -> list[AccessRequest]:
         """
         Get pending access requests for a given gated repo.
 
@@ -8640,14 +8441,14 @@ class HfApi:
                 To disable authentication, pass `False`.
 
         Returns:
-            `List[AccessRequest]`: A list of [`AccessRequest`] objects. Each time contains a `username`, `email`,
+            `list[AccessRequest]`: A list of [`AccessRequest`] objects. Each time contains a `username`, `email`,
             `status` and `timestamp` attribute. If the gated repo has a custom form, the `fields` attribute will
             be populated with user's answers.
 
         Raises:
-            [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError):
+            [`HfHubHTTPError`]:
                 HTTP 400 if the repo is not gated.
-            [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError):
+            [`HfHubHTTPError`]:
                 HTTP 403 if you only have read-only access to the repo. This can be the case if you don't have `write`
                 or `admin` role in the organization the repo belongs to or if you passed a `read` token.
 
@@ -8681,7 +8482,7 @@ class HfApi:
     @validate_hf_hub_args
     def list_accepted_access_requests(
         self, repo_id: str, *, repo_type: Optional[str] = None, token: Union[bool, str, None] = None
-    ) -> List[AccessRequest]:
+    ) -> list[AccessRequest]:
         """
         Get accepted access requests for a given gated repo.
 
@@ -8706,14 +8507,14 @@ class HfApi:
                 To disable authentication, pass `False`.
 
         Returns:
-            `List[AccessRequest]`: A list of [`AccessRequest`] objects. Each time contains a `username`, `email`,
+            `list[AccessRequest]`: A list of [`AccessRequest`] objects. Each time contains a `username`, `email`,
             `status` and `timestamp` attribute. If the gated repo has a custom form, the `fields` attribute will
             be populated with user's answers.
 
         Raises:
-            [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError):
+            [`HfHubHTTPError`]:
                 HTTP 400 if the repo is not gated.
-            [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError):
+            [`HfHubHTTPError`]:
                 HTTP 403 if you only have read-only access to the repo. This can be the case if you don't have `write`
                 or `admin` role in the organization the repo belongs to or if you passed a `read` token.
 
@@ -8743,7 +8544,7 @@ class HfApi:
     @validate_hf_hub_args
     def list_rejected_access_requests(
         self, repo_id: str, *, repo_type: Optional[str] = None, token: Union[bool, str, None] = None
-    ) -> List[AccessRequest]:
+    ) -> list[AccessRequest]:
         """
         Get rejected access requests for a given gated repo.
 
@@ -8768,14 +8569,14 @@ class HfApi:
                 To disable authentication, pass `False`.
 
         Returns:
-            `List[AccessRequest]`: A list of [`AccessRequest`] objects. Each time contains a `username`, `email`,
+            `list[AccessRequest]`: A list of [`AccessRequest`] objects. Each time contains a `username`, `email`,
             `status` and `timestamp` attribute. If the gated repo has a custom form, the `fields` attribute will
             be populated with user's answers.
 
         Raises:
-            [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError):
+            [`HfHubHTTPError`]:
                 HTTP 400 if the repo is not gated.
-            [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError):
+            [`HfHubHTTPError`]:
                 HTTP 403 if you only have read-only access to the repo. This can be the case if you don't have `write`
                 or `admin` role in the organization the repo belongs to or if you passed a `read` token.
 
@@ -8808,7 +8609,7 @@ class HfApi:
         status: Literal["accepted", "rejected", "pending"],
         repo_type: Optional[str] = None,
         token: Union[bool, str, None] = None,
-    ) -> List[AccessRequest]:
+    ) -> list[AccessRequest]:
         if repo_type not in constants.REPO_TYPES:
             raise ValueError(f"Invalid repo type, must be one of {constants.REPO_TYPES}")
         if repo_type is None:
@@ -8857,16 +8658,16 @@ class HfApi:
                 To disable authentication, pass `False`.
 
         Raises:
-            [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError):
+            [`HfHubHTTPError`]:
                 HTTP 400 if the repo is not gated.
-            [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError):
+            [`HfHubHTTPError`]:
                 HTTP 403 if you only have read-only access to the repo. This can be the case if you don't have `write`
                 or `admin` role in the organization the repo belongs to or if you passed a `read` token.
-            [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError):
+            [`HfHubHTTPError`]:
                 HTTP 404 if the user does not exist on the Hub.
-            [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError):
+            [`HfHubHTTPError`]:
                 HTTP 404 if the user access request cannot be found.
-            [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError):
+            [`HfHubHTTPError`]:
                 HTTP 404 if the user access request is already in the pending list.
         """
         self._handle_access_request(repo_id, user, "pending", repo_type=repo_type, token=token)
@@ -8899,16 +8700,16 @@ class HfApi:
                 To disable authentication, pass `False`.
 
         Raises:
-            [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError):
+            [`HfHubHTTPError`]:
                 HTTP 400 if the repo is not gated.
-            [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError):
+            [`HfHubHTTPError`]:
                 HTTP 403 if you only have read-only access to the repo. This can be the case if you don't have `write`
                 or `admin` role in the organization the repo belongs to or if you passed a `read` token.
-            [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError):
+            [`HfHubHTTPError`]:
                 HTTP 404 if the user does not exist on the Hub.
-            [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError):
+            [`HfHubHTTPError`]:
                 HTTP 404 if the user access request cannot be found.
-            [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError):
+            [`HfHubHTTPError`]:
                 HTTP 404 if the user access request is already in the accepted list.
         """
         self._handle_access_request(repo_id, user, "accepted", repo_type=repo_type, token=token)
@@ -8949,16 +8750,16 @@ class HfApi:
                 To disable authentication, pass `False`.
 
         Raises:
-            [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError):
+            [`HfHubHTTPError`]:
                 HTTP 400 if the repo is not gated.
-            [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError):
+            [`HfHubHTTPError`]:
                 HTTP 403 if you only have read-only access to the repo. This can be the case if you don't have `write`
                 or `admin` role in the organization the repo belongs to or if you passed a `read` token.
-            [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError):
+            [`HfHubHTTPError`]:
                 HTTP 404 if the user does not exist on the Hub.
-            [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError):
+            [`HfHubHTTPError`]:
                 HTTP 404 if the user access request cannot be found.
-            [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError):
+            [`HfHubHTTPError`]:
                 HTTP 404 if the user access request is already in the rejected list.
         """
         self._handle_access_request(
@@ -9022,14 +8823,14 @@ class HfApi:
                 To disable authentication, pass `False`.
 
         Raises:
-            [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError):
+            [`HfHubHTTPError`]:
                 HTTP 400 if the repo is not gated.
-            [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError):
+            [`HfHubHTTPError`]:
                 HTTP 400 if the user already has access to the repo.
-            [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError):
+            [`HfHubHTTPError`]:
                 HTTP 403 if you only have read-only access to the repo. This can be the case if you don't have `write`
                 or `admin` role in the organization the repo belongs to or if you passed a `read` token.
-            [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError):
+            [`HfHubHTTPError`]:
                 HTTP 404 if the user does not exist on the Hub.
         """
         if repo_type not in constants.REPO_TYPES:
@@ -9103,7 +8904,7 @@ class HfApi:
         return webhook
 
     @validate_hf_hub_args
-    def list_webhooks(self, *, token: Union[bool, str, None] = None) -> List[WebhookInfo]:
+    def list_webhooks(self, *, token: Union[bool, str, None] = None) -> list[WebhookInfo]:
         """List all configured webhooks.
 
         Args:
@@ -9113,7 +8914,7 @@ class HfApi:
                 To disable authentication, pass `False`.
 
         Returns:
-            `List[WebhookInfo]`:
+            `list[WebhookInfo]`:
                 List of webhook info objects.
 
         Example:
@@ -9159,8 +8960,8 @@ class HfApi:
         *,
         url: Optional[str] = None,
         job_id: Optional[str] = None,
-        watched: List[Union[Dict, WebhookWatchedItem]],
-        domains: Optional[List[constants.WEBHOOK_DOMAIN_T]] = None,
+        watched: list[Union[dict, WebhookWatchedItem]],
+        domains: Optional[list[constants.WEBHOOK_DOMAIN_T]] = None,
         secret: Optional[str] = None,
         token: Union[bool, str, None] = None,
     ) -> WebhookInfo:
@@ -9175,10 +8976,10 @@ class HfApi:
             job_id (`str`):
                 ID of the source Job to trigger with the webhook payload in the environment variable WEBHOOK_PAYLOAD.
                 Additional environment variables are available for convenience: WEBHOOK_REPO_ID, WEBHOOK_REPO_TYPE and WEBHOOK_SECRET.
-            watched (`List[WebhookWatchedItem]`):
+            watched (`list[WebhookWatchedItem]`):
                 List of [`WebhookWatchedItem`] to be watched by the webhook. It can be users, orgs, models, datasets or spaces.
                 Watched items can also be provided as plain dictionaries.
-            domains (`List[Literal["repo", "discussion"]]`, optional):
+            domains (`list[Literal["repo", "discussion"]]`, optional):
                 List of domains to watch. It can be "repo", "discussion" or both.
             secret (`str`, optional):
                 A secret to sign the payload with.
@@ -9289,8 +9090,8 @@ class HfApi:
         webhook_id: str,
         *,
         url: Optional[str] = None,
-        watched: Optional[List[Union[Dict, WebhookWatchedItem]]] = None,
-        domains: Optional[List[constants.WEBHOOK_DOMAIN_T]] = None,
+        watched: Optional[list[Union[dict, WebhookWatchedItem]]] = None,
+        domains: Optional[list[constants.WEBHOOK_DOMAIN_T]] = None,
         secret: Optional[str] = None,
         token: Union[bool, str, None] = None,
     ) -> WebhookInfo:
@@ -9301,10 +9102,10 @@ class HfApi:
                 The unique identifier of the webhook to be updated.
             url (`str`, optional):
                 The URL to which the payload will be sent.
-            watched (`List[WebhookWatchedItem]`, optional):
+            watched (`list[WebhookWatchedItem]`, optional):
                 List of items to watch. It can be users, orgs, models, datasets, or spaces.
                 Refer to [`WebhookWatchedItem`] for more details. Watched items can also be provided as plain dictionaries.
-            domains (`List[Literal["repo", "discussion"]]`, optional):
+            domains (`list[Literal["repo", "discussion"]]`, optional):
                 The domains to watch. This can include "repo", "discussion", or both.
             secret (`str`, optional):
                 A secret to sign the payload with, providing an additional layer of security.
@@ -9506,8 +9307,8 @@ class HfApi:
         token: Union[bool, str, None] = None,
         library_name: Optional[str] = None,
         library_version: Optional[str] = None,
-        user_agent: Union[Dict, str, None] = None,
-    ) -> Dict[str, str]:
+        user_agent: Union[dict, str, None] = None,
+    ) -> dict[str, str]:
         """
         Alias for [`build_hf_headers`] that uses the token from [`HfApi`] client
         when `token` is not provided.
@@ -9529,9 +9330,9 @@ class HfApi:
         repo_type: Optional[str],
         revision: Optional[str],
         path_in_repo: str,
-        delete_patterns: Optional[Union[List[str], str]],
+        delete_patterns: Optional[Union[list[str], str]],
         token: Union[bool, str, None] = None,
-    ) -> List[CommitOperationDelete]:
+    ) -> list[CommitOperationDelete]:
         """Generate the list of Delete operations for a commit to delete files from a repo.
 
         List remote files and match them against the `delete_patterns` constraints. Returns a list of [`CommitOperationDelete`]
@@ -9567,11 +9368,11 @@ class HfApi:
         self,
         folder_path: Union[str, Path],
         path_in_repo: str,
-        allow_patterns: Optional[Union[List[str], str]] = None,
-        ignore_patterns: Optional[Union[List[str], str]] = None,
+        allow_patterns: Optional[Union[list[str], str]] = None,
+        ignore_patterns: Optional[Union[list[str], str]] = None,
         repo_type: Optional[str] = None,
         token: Union[bool, str, None] = None,
-    ) -> List[CommitOperationAdd]:
+    ) -> list[CommitOperationAdd]:
         """Generate the list of Add operations for a commit to upload a folder.
 
         Files not matching the `allow_patterns` (allowlist) and `ignore_patterns` (denylist)
@@ -9686,7 +9487,7 @@ class HfApi:
             `User`: A [`User`] object with the user's overview.
 
         Raises:
-            [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError):
+            [`HfHubHTTPError`]:
                 HTTP 404 If the user does not exist on the Hub.
         """
         r = get_session().get(
@@ -9722,6 +9523,35 @@ class HfApi:
         hf_raise_for_status(r)
         return Organization(**r.json())
 
+    @validate_hf_hub_args
+    def list_organization_followers(self, organization: str, token: Union[bool, str, None] = None) -> Iterable[User]:
+        """
+        List followers of an organization on the Hub.
+
+        Args:
+            organization (`str`):
+                Name of the organization to get the followers of.
+            token (`bool` or `str`, *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[User]`: A list of [`User`] objects with the followers of the organization.
+
+        Raises:
+            [`HfHubHTTPError`]:
+                HTTP 404 If the organization does not exist on the Hub.
+
+        """
+        for follower in paginate(
+            path=f"{constants.ENDPOINT}/api/organizations/{organization}/followers",
+            params={},
+            headers=self._build_hf_headers(token=token),
+        ):
+            yield User(**follower)
+
     def list_organization_members(self, organization: str, token: Union[bool, str, None] = None) -> Iterable[User]:
         """
         List of members of an organization on the Hub.
@@ -9739,7 +9569,7 @@ class HfApi:
             `Iterable[User]`: A list of [`User`] objects with the members of the organization.
 
         Raises:
-            [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError):
+            [`HfHubHTTPError`]:
                 HTTP 404 If the organization does not exist on the Hub.
 
         """
@@ -9767,7 +9597,7 @@ class HfApi:
             `Iterable[User]`: A list of [`User`] objects with the followers of the user.
 
         Raises:
-            [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError):
+            [`HfHubHTTPError`]:
                 HTTP 404 If the user does not exist on the Hub.
 
         """
@@ -9795,7 +9625,7 @@ class HfApi:
             `Iterable[User]`: A list of [`User`] objects with the users followed by the user.
 
         Raises:
-            [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError):
+            [`HfHubHTTPError`]:
                 HTTP 404 If the user does not exist on the Hub.
 
         """
@@ -9864,7 +9694,7 @@ class HfApi:
             `PaperInfo`: A `PaperInfo` object.
 
         Raises:
-            [`HTTPError`](https://requests.readthedocs.io/en/latest/api/#requests.HTTPError):
+            [`HfHubHTTPError`]:
                 HTTP 404 If the paper does not exist on the Hub.
         """
         path = f"{self.endpoint}/api/papers/{id}"
@@ -9940,9 +9770,9 @@ class HfApi:
         self,
         *,
         image: str,
-        command: List[str],
-        env: Optional[Dict[str, Any]] = None,
-        secrets: Optional[Dict[str, Any]] = None,
+        command: list[str],
+        env: Optional[dict[str, Any]] = None,
+        secrets: Optional[dict[str, Any]] = None,
         flavor: Optional[SpaceHardware] = None,
         timeout: Optional[Union[int, float, str]] = None,
         namespace: Optional[str] = None,
@@ -9957,13 +9787,13 @@ class HfApi:
                 Examples: `"ubuntu"`, `"python:3.12"`, `"pytorch/pytorch:2.6.0-cuda12.4-cudnn9-devel"`.
                 Example with an image from a Space: `"hf.co/spaces/lhoestq/duckdb"`.
 
-            command (`List[str]`):
+            command (`list[str]`):
                 The command to run. Example: `["echo", "hello"]`.
 
-            env (`Dict[str, Any]`, *optional*):
+            env (`dict[str, Any]`, *optional*):
                 Defines the environment variables for the Job.
 
-            secrets (`Dict[str, Any]`, *optional*):
+            secrets (`dict[str, Any]`, *optional*):
                 Defines the secret environment variables for the Job.
 
             flavor (`str`, *optional*):
@@ -10072,29 +9902,28 @@ class HfApi:
             time.sleep(sleep_time)
             sleep_time = min(max_wait_time, max(min_wait_time, sleep_time * 2))
             try:
-                resp = get_session().get(
+                with get_session().stream(
+                    "GET",
                     f"https://huggingface.co/api/jobs/{namespace}/{job_id}/logs",
                     headers=self._build_hf_headers(token=token),
-                    stream=True,
                     timeout=120,
-                )
-                log = None
-                for line in resp.iter_lines(chunk_size=1):
-                    line = line.decode("utf-8")
-                    if line and line.startswith("data: {"):
-                        data = json.loads(line[len("data: ") :])
-                        # timestamp = data["timestamp"]
-                        if not data["data"].startswith("===== Job started"):
-                            logging_started = True
-                            log = data["data"]
-                            yield log
-                logging_finished = logging_started
-            except requests.exceptions.ChunkedEncodingError:
+                ) as response:
+                    log = None
+                    for line in response.iter_lines():
+                        if line and line.startswith("data: {"):
+                            data = json.loads(line[len("data: ") :])
+                            # timestamp = data["timestamp"]
+                            if not data["data"].startswith("===== Job started"):
+                                logging_started = True
+                                log = data["data"]
+                                yield log
+                    logging_finished = logging_started
+            except httpx.DecodingError:
                 # Response ended prematurely
                 break
             except KeyboardInterrupt:
                 break
-            except requests.exceptions.ConnectionError as err:
+            except httpx.NetworkError as err:
                 is_timeout = err.__context__ and isinstance(getattr(err.__context__, "__cause__", None), TimeoutError)
                 if logging_started or not is_timeout:
                     raise
@@ -10117,7 +9946,7 @@ class HfApi:
         timeout: Optional[int] = None,
         namespace: Optional[str] = None,
         token: Union[bool, str, None] = None,
-    ) -> List[JobInfo]:
+    ) -> list[JobInfo]:
         """
         List compute Jobs on Hugging Face infrastructure.
 
@@ -10228,12 +10057,12 @@ class HfApi:
         self,
         script: str,
         *,
-        script_args: Optional[List[str]] = None,
-        dependencies: Optional[List[str]] = None,
+        script_args: Optional[list[str]] = None,
+        dependencies: Optional[list[str]] = None,
         python: Optional[str] = None,
         image: Optional[str] = None,
-        env: Optional[Dict[str, Any]] = None,
-        secrets: Optional[Dict[str, Any]] = None,
+        env: Optional[dict[str, Any]] = None,
+        secrets: Optional[dict[str, Any]] = None,
         flavor: Optional[SpaceHardware] = None,
         timeout: Optional[Union[int, float, str]] = None,
         namespace: Optional[str] = None,
@@ -10247,10 +10076,10 @@ class HfApi:
             script (`str`):
                 Path or URL of the UV script, or a command.
 
-            script_args (`List[str]`, *optional*)
+            script_args (`list[str]`, *optional*)
                 Arguments to pass to the script or command.
 
-            dependencies (`List[str]`, *optional*)
+            dependencies (`list[str]`, *optional*)
                 Dependencies to use to run the UV script.
 
             python (`str`, *optional*)
@@ -10259,10 +10088,10 @@ class HfApi:
             image (`str`, *optional*, defaults to "ghcr.io/astral-sh/uv:python3.12-bookworm"):
                 Use a custom Docker image with `uv` installed.
 
-            env (`Dict[str, Any]`, *optional*):
+            env (`dict[str, Any]`, *optional*):
                 Defines the environment variables for the Job.
 
-            secrets (`Dict[str, Any]`, *optional*):
+            secrets (`dict[str, Any]`, *optional*):
                 Defines the secret environment variables for the Job.
 
             flavor (`str`, *optional*):
@@ -10342,12 +10171,12 @@ class HfApi:
         self,
         *,
         image: str,
-        command: List[str],
+        command: list[str],
         schedule: str,
         suspend: Optional[bool] = None,
         concurrency: Optional[bool] = None,
-        env: Optional[Dict[str, Any]] = None,
-        secrets: Optional[Dict[str, Any]] = None,
+        env: Optional[dict[str, Any]] = None,
+        secrets: Optional[dict[str, Any]] = None,
         flavor: Optional[SpaceHardware] = None,
         timeout: Optional[Union[int, float, str]] = None,
         namespace: Optional[str] = None,
@@ -10362,7 +10191,7 @@ class HfApi:
                 Examples: `"ubuntu"`, `"python:3.12"`, `"pytorch/pytorch:2.6.0-cuda12.4-cudnn9-devel"`.
                 Example with an image from a Space: `"hf.co/spaces/lhoestq/duckdb"`.
 
-            command (`List[str]`):
+            command (`list[str]`):
                 The command to run. Example: `["echo", "hello"]`.
 
             schedule (`str`):
@@ -10375,10 +10204,10 @@ class HfApi:
             concurrency (`bool`, *optional*):
                 If True, multiple instances of this Job can run concurrently. Defaults to False.
 
-            env (`Dict[str, Any]`, *optional*):
+            env (`dict[str, Any]`, *optional*):
                 Defines the environment variables for the Job.
 
-            secrets (`Dict[str, Any]`, *optional*):
+            secrets (`dict[str, Any]`, *optional*):
                 Defines the secret environment variables for the Job.
 
             flavor (`str`, *optional*):
@@ -10434,7 +10263,7 @@ class HfApi:
             flavor=flavor,
             timeout=timeout,
         )
-        input_json: Dict[str, Any] = {
+        input_json: dict[str, Any] = {
             "jobSpec": job_spec,
             "schedule": schedule,
         }
@@ -10457,7 +10286,7 @@ class HfApi:
         timeout: Optional[int] = None,
         namespace: Optional[str] = None,
         token: Union[bool, str, None] = None,
-    ) -> List[ScheduledJobInfo]:
+    ) -> list[ScheduledJobInfo]:
         """
         List scheduled compute Jobs on Hugging Face infrastructure.
 
@@ -10615,15 +10444,15 @@ class HfApi:
         self,
         script: str,
         *,
-        script_args: Optional[List[str]] = None,
+        script_args: Optional[list[str]] = None,
         schedule: str,
         suspend: Optional[bool] = None,
         concurrency: Optional[bool] = None,
-        dependencies: Optional[List[str]] = None,
+        dependencies: Optional[list[str]] = None,
         python: Optional[str] = None,
         image: Optional[str] = None,
-        env: Optional[Dict[str, Any]] = None,
-        secrets: Optional[Dict[str, Any]] = None,
+        env: Optional[dict[str, Any]] = None,
+        secrets: Optional[dict[str, Any]] = None,
         flavor: Optional[SpaceHardware] = None,
         timeout: Optional[Union[int, float, str]] = None,
         namespace: Optional[str] = None,
@@ -10637,7 +10466,7 @@ class HfApi:
             script (`str`):
                 Path or URL of the UV script, or a command.
 
-            script_args (`List[str]`, *optional*)
+            script_args (`list[str]`, *optional*)
                 Arguments to pass to the script, or a command.
 
             schedule (`str`):
@@ -10650,7 +10479,7 @@ class HfApi:
             concurrency (`bool`, *optional*):
                 If True, multiple instances of this Job can run concurrently. Defaults to False.
 
-            dependencies (`List[str]`, *optional*)
+            dependencies (`list[str]`, *optional*)
                 Dependencies to use to run the UV script.
 
             python (`str`, *optional*)
@@ -10659,10 +10488,10 @@ class HfApi:
             image (`str`, *optional*, defaults to "ghcr.io/astral-sh/uv:python3.12-bookworm"):
                 Use a custom Docker image with `uv` installed.
 
-            env (`Dict[str, Any]`, *optional*):
+            env (`dict[str, Any]`, *optional*):
                 Defines the environment variables for the Job.
 
-            secrets (`Dict[str, Any]`, *optional*):
+            secrets (`dict[str, Any]`, *optional*):
                 Defines the secret environment variables for the Job.
 
             flavor (`str`, *optional*):
@@ -10742,15 +10571,15 @@ class HfApi:
         self,
         *,
         script: str,
-        script_args: Optional[List[str]],
-        dependencies: Optional[List[str]],
+        script_args: Optional[list[str]],
+        dependencies: Optional[list[str]],
         python: Optional[str],
-        env: Optional[Dict[str, Any]],
-        secrets: Optional[Dict[str, Any]],
+        env: Optional[dict[str, Any]],
+        secrets: Optional[dict[str, Any]],
         namespace: Optional[str],
         token: Union[bool, str, None],
         _repo: Optional[str],
-    ) -> Tuple[List[str], Dict[str, Any], Dict[str, Any]]:
+    ) -> tuple[list[str], dict[str, Any], dict[str, Any]]:
         env = env or {}
         secrets = secrets or {}
 
@@ -10882,7 +10711,6 @@ api = HfApi()
 
 whoami = api.whoami
 auth_check = api.auth_check
-get_token_permission = api.get_token_permission
 
 list_models = api.list_models
 model_info = api.model_info
@@ -10912,7 +10740,6 @@ get_dataset_tags = api.get_dataset_tags
 create_commit = api.create_commit
 create_repo = api.create_repo
 delete_repo = api.delete_repo
-update_repo_visibility = api.update_repo_visibility
 update_repo_settings = api.update_repo_settings
 move_repo = api.move_repo
 upload_file = api.upload_file
@@ -11016,6 +10843,7 @@ update_webhook = api.update_webhook
 # User API
 get_user_overview = api.get_user_overview
 get_organization_overview = api.get_organization_overview
+list_organization_followers = api.list_organization_followers
 list_organization_members = api.list_organization_members
 list_user_followers = api.list_user_followers
 list_user_following = api.list_user_following