> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Hugging Face

> How to set up the Hugging Face connector, plus the actions that are available.

![Hugging Face](https://stackone-logos.com/api/hugging-face/filled/svg)

Previewv0.1.0[See changelog](https://docs.stackone.com/connectors/huggingface/changelog.md)

[126 actions](#actions) · 2 auth methods

AI
Productivity
Developer Tools
IAM
Storage
Billing

## Getting Started

**1. Create or Select a Project**

Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md).

**2. Configure the Connector**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

> [card] [User Access Token · Connector Profile](https://docs.stackone.com/connectors/huggingface/guides/connector-profile/user-access-token.md)
>
> No app registration required. A token created from account settings, carrying either blanket read/write access or fine-g...

> [card] [OAuth 2.0 · Connector Profile](https://docs.stackone.com/connectors/huggingface/guides/connector-profile/oauth-2-0.md)
>
> Acts on behalf of a signed-in Hugging Face user with per-scope consent. Requires registering an OAuth application. Acces...

**3. Link an Account**

Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)).

See the guide for the authentication type chosen in the Connector Profile:

> [card] [User Access Token · Link Account](https://docs.stackone.com/connectors/huggingface/guides/link-account/user-access-token.md)

> [card] [OAuth 2.0 · Link Account](https://docs.stackone.com/connectors/huggingface/guides/link-account/oauth-2-0.md)

**4. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Actions

Authentication type

Select all
|
Clear

OAuth 2.0

User Access Token

No auth methods found

Scopes

Select all
|
Clear

contribute-repos

manage-repos

profile

read-billing

read-collections

read-memberships

read-repos

write-collections

write-discussions

write-repos

No scopes found

126 actions

ActionDescriptionRequired scopes

List Collections`huggingface_list_collections`

List collections, optionally filtered by owner or by an item they contain

`read-collections`

Get Collection`huggingface_get_collection`

Get one collection with its items

`read-collections`

Create Collection`huggingface_create_collection`

Create a collection owned by the authenticated user or an organization

`write-collections`

Update Collection`huggingface_update_collection`

Update a collection's title, description, position or visibility

`write-collections`

Delete Collection`huggingface_delete_collection`

Delete a collection, leaving the repositories it referenced untouched

`write-collections`

Add Collection Item`huggingface_add_collection_item`

Add a model, dataset, Space, paper or collection to a collection

`write-collections`

Batch Update Collection Items`huggingface_batch_update_collection_items`

Reorder or bulk-edit the items of a collection in one call

`write-collections`

Delete Collection Item`huggingface_delete_collection_item`

Remove one item from a collection

`write-collections`

List Datasets`huggingface_list_datasets`

Search and filter dataset repositories on the Hub

`read-repos`

Get Dataset`huggingface_get_dataset`

Get one dataset repository including its card metadata

`read-repos`

List Dataset Access Requests`huggingface_list_dataset_access_requests`

List access requests on a gated dataset repository by status

Batch Handle Dataset Access Requests`huggingface_batch_handle_dataset_access_requests`

Accept or reject many pending access requests in one call

Grant Dataset Access`huggingface_grant_dataset_access`

Grant a user access to a gated dataset repository

Handle Dataset Access Request`huggingface_handle_dataset_access_request`

Accept or reject one pending access request on a gated dataset repository

Export Dataset Access Report`huggingface_export_dataset_access_report`

Export the access report of a gated dataset repository as CSV

Create Dataset Branch`huggingface_create_dataset_branch`

Create a branch in a dataset repository

`write-repos`

Delete Dataset Branch`huggingface_delete_dataset_branch`

Delete a branch from a dataset repository

`write-repos`

List Dataset Commits`huggingface_list_dataset_commits`

List the commit history of a dataset repository at a revision

`read-repos`

Compare Dataset Revisions`huggingface_compare_dataset_revisions`

Compare two revisions of a dataset repository

`read-repos`

Squash Dataset History`huggingface_squash_dataset_history`

Collapse the history of a dataset repository branch into a single commit

`write-repos`

Commit To Dataset`huggingface_commit_to_dataset`

Add, update, move or delete files in a dataset repository as one commit

`write-repos`

List Dataset Files`huggingface_list_dataset_files`

List the files and folders of a dataset repository at a revision

`read-repos`

List Dataset Parquet Files`huggingface_list_dataset_parquet_files`

List the Parquet exports the Hub auto-generates for a dataset

`read-repos`

Check Dataset Upload Method`huggingface_check_dataset_upload_method`

Ask the Hub whether files should be uploaded as regular or large files

`write-repos`

Get Dataset Folder Size`huggingface_get_dataset_folder_size`

Get the total size of a folder in a dataset repository

`read-repos`

Get Dataset Paths Info`huggingface_get_dataset_paths_info`

Get metadata for specific paths in a dataset repository

`read-repos`

List Dataset Large Files`huggingface_list_dataset_large_files`

List the LFS and Xet-backed large files of a dataset repository

`read-repos`

Delete Dataset Large File`huggingface_delete_dataset_large_file`

Delete one large file from a dataset repository by its SHA

`write-repos`

Delete Dataset Large Files`huggingface_delete_dataset_large_files`

Delete several large files from a dataset repository in one call

`write-repos`

Get Dataset Leaderboard`huggingface_get_dataset_leaderboard`

Get the evaluation leaderboard attached to a dataset

`read-repos`

List Dataset References`huggingface_list_dataset_refs`

List the branches, tags and pull-request refs of a dataset repository

`read-repos`

Get Dataset At Revision`huggingface_get_dataset_revision`

Get one dataset repository as of a specific Git revision

`read-repos`

Get Dataset Security Status`huggingface_get_dataset_security_status`

Read the malware, secret and pickle scan verdict for a dataset repository

`read-repos`

Update Dataset Settings`huggingface_update_dataset_settings`

Update the settings of a dataset repository including visibility and gating

`write-repos`

List Dataset Tag Types`huggingface_list_dataset_tag_types`

List the dataset tag taxonomy grouped by type, such as task categories, sizes and licences

Create Dataset Tag`huggingface_create_dataset_tag`

Tag a revision of a dataset repository

`write-repos`

Delete Dataset Tag`huggingface_delete_dataset_tag`

Delete a tag from a dataset repository

`write-repos`

List Discussions`huggingface_list_discussions`

List the discussions and pull requests on a repository

`read-repos`

Get Discussion`huggingface_get_discussion`

Get one discussion or pull request with its full comment thread

`read-repos`

Create Discussion`huggingface_create_discussion`

Open a new discussion or pull request on a repository

`write-discussions`

Pin Discussion`huggingface_pin_discussion`

Pin or unpin a discussion on a repository

`write-discussions`

Update Discussion Status`huggingface_update_discussion_status`

Open, close or reopen a discussion or pull request

`write-discussions`

Update Discussion Title`huggingface_update_discussion_title`

Rename a discussion or pull request

`write-discussions`

Delete Discussion`huggingface_delete_discussion`

Delete a discussion together with its comments

`write-discussions`

Create Discussion Comment`huggingface_create_discussion_comment`

Post a comment on a discussion or pull request

`write-discussions`

Get Pull Request Storage Estimate`huggingface_get_pull_request_storage_estimate`

Estimate the LFS storage a pull request holds that deleting its ref would free

`read-repos`

Merge Pull Request`huggingface_merge_pull_request`

Merge an open pull request into its target branch

`write-repos`

Delete Pull Request Ref`huggingface_delete_pull_request_ref`

Delete the Git ref backing a pull request

`write-repos`

List Models`huggingface_list_models`

Search and filter model repositories on the Hub

`read-repos`

Get Model`huggingface_get_model`

Get one model repository including its card metadata

`read-repos`

List Model Access Requests`huggingface_list_model_access_requests`

List access requests on a gated model repository by status

Batch Handle Model Access Requests`huggingface_batch_handle_model_access_requests`

Accept or reject many pending access requests in one call

Grant Model Access`huggingface_grant_model_access`

Grant a user access to a gated model repository

Handle Model Access Request`huggingface_handle_model_access_request`

Accept or reject one pending access request on a gated model repository

Export Model Access Report`huggingface_export_model_access_report`

Export the access report of a gated model repository as CSV

Create Model Branch`huggingface_create_model_branch`

Create a branch in a model repository

`write-repos`

Delete Model Branch`huggingface_delete_model_branch`

Delete a branch from a model repository

`write-repos`

List Model Commits`huggingface_list_model_commits`

List the commit history of a model repository at a revision

`read-repos`

Compare Model Revisions`huggingface_compare_model_revisions`

Compare two revisions of a model repository

`read-repos`

Squash Model History`huggingface_squash_model_history`

Collapse the history of a model repository branch into a single commit

`write-repos`

Commit To Model`huggingface_commit_to_model`

Add, update, move or delete files in a model repository as one commit

`write-repos`

List Model Files`huggingface_list_model_files`

List the files and folders of a model repository at a revision

`read-repos`

Check Model Upload Method`huggingface_check_model_upload_method`

Ask the Hub whether files should be uploaded as regular or large files

`write-repos`

Get Model Folder Size`huggingface_get_model_folder_size`

Get the total size of a folder in a model repository

`read-repos`

Get Model Paths Info`huggingface_get_model_paths_info`

Get metadata for specific paths in a model repository

`read-repos`

List Model Large Files`huggingface_list_model_large_files`

List the LFS and Xet-backed large files of a model repository

`read-repos`

Delete Model Large File`huggingface_delete_model_large_file`

Delete one large file from a model repository by its SHA

`write-repos`

Delete Model Large Files`huggingface_delete_model_large_files`

Delete several large files from a model repository in one call

`write-repos`

List Model References`huggingface_list_model_refs`

List the branches, tags and pull-request refs of a model repository

`read-repos`

Get Model At Revision`huggingface_get_model_revision`

Get one model repository as of a specific Git revision

`read-repos`

Get Model Security Status`huggingface_get_model_security_status`

Read the malware, secret and pickle scan verdict for a model repository

`read-repos`

Update Model Settings`huggingface_update_model_settings`

Update the settings of a model repository including visibility and gating

`write-repos`

List Model Tag Types`huggingface_list_model_tag_types`

List the model tag taxonomy grouped by type, such as tasks, libraries and licences

Create Model Tag`huggingface_create_model_tag`

Tag a revision of a model repository

`write-repos`

Delete Model Tag`huggingface_delete_model_tag`

Delete a tag from a model repository

`write-repos`

Get Organization`huggingface_get_organization`

Get the public overview of an organization

Get Organization Social Handles`huggingface_get_organization_social_handles`

Get an organization's linked social accounts

Export Organization Audit Log`huggingface_export_organization_audit_log`

Export an organization's audit log

List Organization Members`huggingface_list_organization_members`

List the members of an organization with their roles

`read-memberships`

List Organization Repositories`huggingface_list_organization_repositories`

List the repositories owned by an organization, including private ones

`read-repos`

Get Organization Inference Session Usage`huggingface_get_organization_inference_session_usage`

Get an organization's inference usage broken down by session

`read-billing`

Get Organization Usage`huggingface_get_organization_usage`

Get an organization's compute and storage usage

`read-billing`

Get Organization Usage By Resource Group`huggingface_get_organization_usage_by_resource_group`

Get an organization's usage broken down by resource group

`read-billing`

Create Repository`huggingface_create_repository`

Create a model, dataset or Space repository

`contribute-repos`

Duplicate Repository`huggingface_duplicate_repository`

Copy an existing model, dataset or Space into a new one

`contribute-repos`

Move Repository`huggingface_move_repository`

Rename a repository or move it to another namespace

`manage-repos`

Delete Repository`huggingface_delete_repository`

Delete a repository together with its files, history and discussions

`manage-repos`

List Spaces`huggingface_list_spaces`

Search and filter Space repositories on the Hub

`read-repos`

Get Space`huggingface_get_space`

Get one Space repository including its card metadata

`read-repos`

Create Space Branch`huggingface_create_space_branch`

Create a branch in a Space repository

`write-repos`

Delete Space Branch`huggingface_delete_space_branch`

Delete a branch from a Space repository

`write-repos`

List Space Commits`huggingface_list_space_commits`

List the commit history of a Space repository at a revision

`read-repos`

Compare Space Revisions`huggingface_compare_space_revisions`

Compare two revisions of a Space repository

`read-repos`

Squash Space History`huggingface_squash_space_history`

Collapse the history of a Space repository branch into a single commit

`write-repos`

Commit To Space`huggingface_commit_to_space`

Add, update, move or delete files in a Space repository as one commit

`write-repos`

List Space Files`huggingface_list_space_files`

List the files and folders of a Space repository at a revision

`read-repos`

Check Space Upload Method`huggingface_check_space_upload_method`

Ask the Hub whether files should be uploaded as regular or large files

`write-repos`

Get Space Folder Size`huggingface_get_space_folder_size`

Get the total size of a folder in a Space repository

`read-repos`

Get Space Paths Info`huggingface_get_space_paths_info`

Get metadata for specific paths in a Space repository

`read-repos`

List Space Hardware`huggingface_list_space_hardware`

List the hardware flavours a Space can run on

List Space Large Files`huggingface_list_space_large_files`

List the LFS and Xet-backed large files of a Space repository

`read-repos`

Delete Space Large File`huggingface_delete_space_large_file`

Delete one large file from a Space repository by its SHA

`write-repos`

Delete Space Large Files`huggingface_delete_space_large_files`

Delete several large files from a Space repository in one call

`write-repos`

List Space References`huggingface_list_space_refs`

List the branches, tags and pull-request refs of a Space repository

`read-repos`

Get Space At Revision`huggingface_get_space_revision`

Get one Space repository as of a specific Git revision

`read-repos`

List Space Secrets`huggingface_list_space_secrets`

List the secret names configured on a Space, without their values

`write-repos`

Upsert Space Secret`huggingface_upsert_space_secret`

Create or overwrite a secret on a Space

`write-repos`

Delete Space Secret`huggingface_delete_space_secret`

Delete a secret from a Space

`write-repos`

Get Space Security Status`huggingface_get_space_security_status`

Read the malware, secret and pickle scan verdict for a Space repository

`read-repos`

Update Space Settings`huggingface_update_space_settings`

Update a Space repository's visibility and discussion-board settings

`write-repos`

Create Space Tag`huggingface_create_space_tag`

Tag a revision of a Space repository

`write-repos`

Delete Space Tag`huggingface_delete_space_tag`

Delete a tag from a Space repository

`write-repos`

List Space Templates`huggingface_list_space_templates`

List the starter templates available when creating a Space

List Space Variables`huggingface_list_space_variables`

List the public environment variables configured on a Space

`write-repos`

Upsert Space Variable`huggingface_upsert_space_variable`

Create or overwrite a public environment variable on a Space

`write-repos`

Delete Space Variable`huggingface_delete_space_variable`

Delete a public environment variable from a Space

`write-repos`

Set Space Volumes`huggingface_set_space_volumes`

Attach or resize the persistent storage volumes of a Space

`write-repos`

Delete Space Volumes`huggingface_delete_space_volumes`

Detach every persistent storage volume from a Space

`write-repos`

Get Current User`huggingface_get_current_user`

Get the identity behind the credential, including organizations and the auth method used

`profile`

Get User Overview`huggingface_get_user_overview`

Get another user's public profile and activity counts

Get User Social Handles`huggingface_get_user_social_handles`

Get a user's linked social accounts

List User Likes`huggingface_list_user_likes`

List the repositories a user has liked

List My Repositories`huggingface_list_my_repositories`

List the repositories owned by the authenticated user, including private ones

`read-repos`

Get My Inference Session Usage`huggingface_get_my_inference_session_usage`

Get the authenticated user's inference usage broken down by session

`read-billing`

Get My Jobs Usage`huggingface_get_my_jobs_usage`

Get the authenticated user's Jobs compute usage

`read-billing`

Get My Usage`huggingface_get_my_usage`

Get the authenticated user's compute and storage usage

`read-billing`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.