Skip to content

Hub API compatibility matrix

Every Hugging Face Hub endpoint that huggingface_hub and the libraries built on it call, and whether Hangar serves it. The compatibility suite in compat/hf writes this table from its own results, so every row marked supported is covered by a passing test against real clients.

Tested with huggingface_hub 2.2.0. 4 not supported, 65 supported.

Endpoint Status Covered by Notes
GET /api/collections Supported test_collections
POST /api/collections Supported test_collections
DELETE /api/collections/{slug} Supported test_collections
GET /api/collections/{slug} Supported test_collections
PATCH /api/collections/{slug} Supported test_collections
POST /api/collections/{slug}/items Supported test_collections
DELETE /api/collections/{slug}/items/{id} Supported test_collections
PATCH /api/collections/{slug}/items/{id} Supported test_collections
GET /api/datasets Supported test_list_models_and_datasets
GET /api/datasets/{repo} Supported test_create_repo_variants
GET /api/models Supported test_list_models_and_datasets
GET /api/models/{repo} Supported test_create_repo_variants, test_model_info_shape
GET /api/models/{repo}/revision/{rev} Supported test_exists_checks
POST /api/repos/create Supported test_create_repo_variants
DELETE /api/repos/delete Supported test_delete_repo, test_write_token_administers_own_repos
POST /api/repos/move Supported test_move_repo_redirects
/api/spaces/... Not supported - Spaces are out of scope.
GET /api/users/{user}/likes Supported test_likers_and_liked_repos
POST /api/validate-yaml Supported test_upload_file_and_folder
GET /api/whoami-v2 Supported test_whoami
GET /api/whoami-v2 (hf auth) Supported test_hf_auth_login_and_whoami
DELETE /api/{type}s/{repo}/branch/{branch} Supported test_branches_and_tags
POST /api/{type}s/{repo}/branch/{branch} Supported test_branches_and_tags
POST /api/{type}s/{repo}/commit/{rev} Supported test_create_commit_adds_deletes_copies, test_upload_file_and_folder, test_upload_large_file_round_trip, test_upload_many_files, test_upload_of_an_object_stored_in_another_users_private_repo, test_upload_over_multipart_threshold
POST /api/{type}s/{repo}/commit/{rev}?create_pr=1 Supported test_failed_create_pr_commit_opens_no_pull_request, test_hf_upload_to_new_branch_and_pr
GET /api/{type}s/{repo}/commits/{rev} Supported test_list_repo_commits
GET /api/{type}s/{repo}/discussions Supported test_discussions_and_pull_requests, test_failed_create_pr_commit_opens_no_pull_request
POST /api/{type}s/{repo}/discussions Supported test_discussions_and_pull_requests
GET /api/{type}s/{repo}/discussions/{num} Supported test_discussions_and_pull_requests, test_hf_upload_to_new_branch_and_pr
POST /api/{type}s/{repo}/discussions/{num}/comment Supported test_discussions_and_pull_requests
POST /api/{type}s/{repo}/discussions/{num}/comment/{id}/edit Supported test_edit_and_hide_comments
POST /api/{type}s/{repo}/discussions/{num}/comment/{id}/hide Supported test_edit_and_hide_comments
POST /api/{type}s/{repo}/discussions/{num}/merge Supported test_discussions_and_pull_requests
POST /api/{type}s/{repo}/discussions/{num}/status Supported test_discussions_and_pull_requests
POST /api/{type}s/{repo}/discussions/{num}/title Supported test_discussions_and_pull_requests
POST /api/{type}s/{repo}/lfs-files/duplicate Not supported - Cross-Repo LFS copy needs Xet hashes. Copies within a Repo work.
DELETE /api/{type}s/{repo}/like Supported test_unlike
POST /api/{type}s/{repo}/like Supported test_likers_and_liked_repos, test_unlike
GET /api/{type}s/{repo}/likers Supported test_likers_and_liked_repos
POST /api/{type}s/{repo}/paths-info/{rev} Supported test_create_commit_adds_deletes_copies, test_tree_and_paths_info
POST /api/{type}s/{repo}/preupload/{rev} Supported test_upload_file_and_folder, test_upload_many_files, test_upload_over_multipart_threshold
GET /api/{type}s/{repo}/refs Supported test_branches_and_tags
GET /api/{type}s/{repo}/revision/{rev} Supported test_exists_checks, test_snapshot_download_and_offline
PUT /api/{type}s/{repo}/settings Supported test_update_repo_settings, test_write_token_administers_own_repos
POST /api/{type}s/{repo}/tag/{rev} Supported test_branches_and_tags
DELETE /api/{type}s/{repo}/tag/{tag} Supported test_branches_and_tags
GET /api/{type}s/{repo}/tree/{rev}/{path} Supported test_snapshot_download_and_offline, test_tree_and_paths_info
GET /api/{type}s/{repo}/xet-read-token/{rev} Not supported - Hangar never offers Xet downloads; downloads use plain HTTP.
GET /api/{type}s/{repo}/xet-write-token/{rev} Supported test_upload_large_file_round_trip, test_xet_write_token
POST /{repo}.git/info/lfs/objects/batch Supported test_upload_file_and_folder, test_upload_of_an_object_stored_in_another_users_private_repo
POST /{repo}.git/info/lfs/objects/batch (basic, presigned MinIO URL, no Xet) Supported TestHubBasicUploadToMinIOWithoutXet
POST /{repo}.git/info/lfs/objects/batch (multipart) Supported test_upload_over_multipart_threshold
GET /{repo}/resolve/{rev}/{path} Supported test_hf_hub_download_by_revision
HEAD /{repo}/resolve/{rev}/{path} Supported test_hf_hub_download_by_revision
GET /{repo}/resolve/{rev}/{path} (Range) Supported test_ranges_and_safetensors_metadata
GET /{repo}/resolve/{rev}/{path} (no Xet) Supported test_download_with_hf_xet_installed
GET /{repo}/resolve/{rev}/{path} (resume) Supported test_resume_partial_download
HfFileSystem Supported test_datasets_load_dataset, test_hf_file_system
/api/jobs/... and /api/inference/... Not supported - Jobs and the Inference API are out of scope.
hf download Supported test_hf_download_and_upload
redirects for moved Repos Supported test_move_repo_redirects
transformers from_pretrained Supported test_transformers_auto_classes
sentence-transformers load Supported test_sentence_transformers
datasets load_dataset Supported test_datasets_load_dataset
error mapping Supported test_gated_repo, test_not_found_errors, test_private_repos_are_hidden
permissions Supported test_write_permissions
transformers safetensors conversion guard Supported test_pickle_only_model_never_contacts_conversion_space
bad token Supported test_bad_token
hf upload Supported test_hf_download_and_upload

Spaces, the Inference API, Jobs, buckets, kernels and Xet downloads are out of scope for Hangar 1.0; see What Hangar is.