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.