Connectors
AI, LLM & Vector Stores
Hugging Face Hub
Model repository: models, datasets, spaces, and repo file management
Hugging Face Hub API referenceAPI checked August 16, 2026
- Signs in with
- API token
- Runs on
- Cloud or On-Prem Worker
- Operations
- 339
- Ready-made triggers
- 0
Connect Hugging Face Hub
- In Neblex open Connect › Connections and click New Connection.
- Search for Hugging Face Hub and give the connection a clear name.
- Fill in the fields. Secret values are encrypted and never shown again.
- Click Test, then Create Connection.
| Field | What to enter |
|---|---|
| Access tokenRequiredSecret | Hugging Face user access token. |
Use it in a flow
- Open a flow, open the node library and search for Hugging Face Hub.
- Drag it onto the canvas and choose an Operation and your connection.
- Map the operation's fields from earlier steps, or click Map with Matt.
- Use Test this step to see what it returns, then save.
To start a flow from Hugging Face Hub without a ready-made trigger: a Poll for changes trigger can check one of its list operations on a schedule and pass on only what is new; if Hugging Face Hub can send webhooks, a Webhook trigger receives them at its own URL.
Operations
339 operations in 28 groups. Each one is a step you can add to a flow.
Agentic Provisioning9
Create account requestpostAgenticProvisioningAccountRequests | POST | Create account request |
Create deep linkpostAgenticProvisioningDeepLinks | POST | Create deep link |
Get a resource by IDgetAgenticProvisioningResourcesById | GET | Get a resource by ID |
Get healthgetAgenticProvisioningHealth | GET | Get health |
Get servicesgetAgenticProvisioningServices | GET | Get services |
Provision a resourcepostAgenticProvisioningResources | POST | Provision a resource |
Remove resourcepostAgenticProvisioningResourcesByIdRemove | POST | Remove resource |
Rotate resource credentialspostAgenticProvisioningResourcesByIdRotateCredentials | POST | Rotate resource credentials |
Update resource servicepostAgenticProvisioningResourcesByIdUpdateService | POST | Update resource service |
Agents1
Get agent harnesseslistAgentHarnesses | GET | Get the registry of AI agents / harnesses known to the Hub, along with the standard environment variables used to detect them. |
Auth1
Get user infowhoami | GET | Get information about the user and auth method used |
Buckets14
Add resource groupsetBucketResourceGroup | POST | Add the repository to a resource group |
Batch file operationsbucketBatchOps | POST | Accepts NDJSON (newline-delimited JSON) where each line is an addFile, copyFile, or deleteFile instruction. |
Create bucketcreateBucket | POST | Create bucket |
Delete bucketdeleteBucket | DELETE | Delete bucket |
Duplicate xet filesduplicateBucketFiles | POST | Duplicate xet-stored files from this repo (source) into another repo (target) by xet hash, without re-uploading file bytes. |
Get bucket detailsgetBucket | GET | Get bucket details |
Get file metadataresolveBucketFile | GET | Returns file metadata including size, hash, and links to XET authentication |
Get resource groupgetBucketResourceGroup | GET | Get resource group |
List fileslistBucketFiles | GET | List files |
List namespace bucketslistBuckets | GET | List namespace buckets |
List paths infolistBucketPathsInfo | POST | List paths info |
Update bucket settingsupdateBucketSettings | PUT | Update bucket settings |
Xet read tokengetBucketXetReadToken | GET | Get a read short-lived access token for XET |
Xet write tokengetBucketXetWriteToken | GET | Get a write short-lived access token for XET upload |
Collections18
Add itemaddCollectionItem | POST | Add an item to a collection |
Add itempostCollectionsByNamespaceBySlugItems | POST | Add an item to a collection |
Batch update itemsbatchUpdateCollectionItems | POST | Batch update items in a collection |
Batch update itemspostCollectionsByNamespaceBySlugItemsBatch | POST | Batch update items in a collection |
Create a collectioncreateCollection | POST | Create a collection |
Delete a collectiondeleteCollection | DELETE | Delete a collection |
Delete a collectiondeleteCollectionsByNamespaceBySlug | DELETE | Delete a collection |
Delete itemdeleteCollectionItem | DELETE | Delete an item from a collection |
Delete itemdeleteCollectionsByNamespaceBySlugItemsBySlug | DELETE | Delete an item from a collection |
Get a collectiongetCollection | GET | Get a collection |
Get a collectiongetCollectionsByNamespaceBySlug | GET | Get a collection |
Get collection resource groupgetCollectionResourceGroup | GET | Get collection resource group |
Get collection resource groupgetCollectionsByNamespaceBySlugResourceGroup | GET | Get collection resource group |
Get collectionslistCollections | GET | Get collections |
Set collection resource grouppostCollectionsByNamespaceBySlugResourceGroup | POST | Assign, move, or unassign an organization-owned collection to a resource group. |
Set collection resource groupsetCollectionResourceGroup | POST | Assign, move, or unassign an organization-owned collection to a resource group. |
Update a collectionpatchCollectionsByNamespaceBySlug | PATCH | Update a collection |
Update a collectionupdateCollection | PATCH | Update a collection |
Container1
Registry tokengetRegistryToken | GET | Mints a short-lived EdDSA JWT for the HuggingFace container registry, verifiable via the JWK at /api/keys/jwt. |
Datasets35
Add resource groupsetDatasetResourceGroup | POST | Add the repository to a resource group |
Batch handle access requestsbatchDatasetAccessRequests | POST | Accept, reject or reset to pending up to 100 access requests for a single gated repository in one call. |
Cancel access requestcancelDatasetAccessRequest | POST | Cancel the current user's access request to a gated repository |
Check upload methodpostDatasetsByNamespaceByRepoPreuploadByRev | POST | Check if a file should be uploaded through the Large File mechanism or directly. |
Create branchcreateDatasetBranch | POST | Create branch |
Create tagcreateDatasetTag | POST | Create tag |
Delete a branchdeleteDatasetBranch | DELETE | Delete a branch |
Delete a tagdeleteDatasetTag | DELETE | Delete a tag |
Delete Large filedeleteDatasetLfsFile | DELETE | Delete a Xet/LFS file |
Delete Large filesdeleteDatasetLfsFilesBatch | POST | Delete Xet/LFS files in batch |
Duplicate xet filesduplicateDatasetXetFiles | POST | Duplicate xet-stored files from this repo (source) into another repo (target) by xet hash, without re-uploading file bytes. |
Export access reportexportDatasetAccessReport | GET | Export a report of all access requests for a gated repository |
Generate JWTgetDatasetJwt | GET | Generate a JWT token for accessing a repository. |
Get a compare revcompareDatasetRevs | GET | Get a compare rev |
Get dataset leaderboardgetDatasetLeaderboard | GET | Returns the evaluation results ranked by score for a dataset/task |
Get dataset tagsgetDatasetTags | GET | Get all possible tags used for datasets, grouped by tag type. |
Get folder sizegetDatasetTreeSize | GET | Get the total size of a repository at a given revision, optionally under a specific subpath. |
Get notebook URLgetDatasetNotebookUrl | GET | Get a jupyter notebook URL for the requested file |
Get resource groupgetDatasetResourceGroup | GET | Get resource group |
Get security statusgetDatasetSecurityScan | GET | Get the security status of a repo |
Grant accessgrantDatasetAccess | POST | Grant access to a user for a gated repository |
Handle access requesthandleDatasetAccessRequest | POST | Handle a user's access request to a gated repository |
List access requestslistDatasetAccessRequests | GET | List access requests for a gated repository |
List commitslistDatasetCommits | GET | List commits |
List folder contentlistDatasetTree | GET | List the content of a repository tree, with pagination support. |
List Large fileslistDatasetLfsFiles | GET | List Xet/LFS files for a repo |
List paths infolistDatasetPathsInfo | POST | List paths info |
List referenceslistDatasetRefs | GET | List references |
Request accessaskDatasetAccess | POST | Request access to a gated repository. |
Resolve a filegetResolveCacheDatasetsByNamespaceByRepoByRevByPath | GET | This endpoint requires to follow redirection |
Resolve a fileresolveDatasetFile | GET | This endpoint requires to follow redirection |
Squash refsuperSquashDataset | POST | Squash all commits in the current ref into a single commit with the given message. |
Update repo settingsupdateDatasetSettings | PUT | Update the settings of a repo |
Xet read tokengetDatasetXetReadToken | GET | Get a read short-lived access token for XET |
Xet write tokengetDatasetXetWriteToken | GET | Get a write short-lived access token for XET upload |
Discussions20
Change statuschangeDiscussionStatus | POST | Change the status of a discussion |
Change titlechangeDiscussionTitle | POST | Change the title of a discussion |
Create a new commentcommentOnBlog | POST | Create a new comment |
Create a new commentcommentOnDiscussion | POST | Create a new comment |
Create a new commentcommentOnPaper | POST | Create a new comment |
Create a new commentcommentOnPost | POST | Create a new comment |
Create a new commentpostBlogBySlugComment | POST | Create a new comment |
Create a new commentpostBlogBySlugCommentByCommentIdReply | POST | Create a new comment |
Create a new commentreplyToBlogComment | POST | Create a new comment |
Create a new commentreplyToPaperComment | POST | Create a new comment |
Create a new commentreplyToPostComment | POST | Create a new comment |
Create a new discussioncreateDiscussion | POST | Create a new discussion |
Delete a discussiondeleteDiscussion | DELETE | Delete a discussion |
Delete a discussiondeletePost | DELETE | Delete a discussion |
Delete PR refdeletePrRef | DELETE | Deletes the git ref for a closed/merged pull request to free up storage. |
Get discussion detailsgetDiscussion | GET | Get discussion details |
List discussionslistDiscussions | GET | Get discussions for a repo |
Merge a pull requestmergePullRequest | POST | Merge a pull request |
Pin a discussionpinDiscussion | POST | Pin a discussion |
PR storage estimategetPrStorageEstimate | GET | Estimates the LFS storage used by a PR that could be freed if the ref is deleted. |
Docs3
Full-text search docssearchDocsFullText | GET | Full-text search across Hugging Face documentation |
List docslistDocs | GET | Get list of available documentation |
Search docssearchDocs | GET | Search any Hugging Face documentation |
Inference Endpoints2
Check accesspostInferenceEndpointsByNamespaceAuthCheckByPerms | POST | Check if the user has access to the inference endpoint |
Check accesspostInferenceEndpointsByNamespaceByEndpointAuthCheckByPerms | POST | Check if the user has access to the inference endpoint |
Jobs23
Cancel a jobcancelJob | POST | Cancel a job |
Check accesspostJobsByNamespaceAuthCheckByPerms | POST | Check if the user has access to jobs in the namespace |
Check accesspostJobsByNamespaceByJobIdAuthCheckByPerms | POST | Check if the user has access to jobs in the namespace |
Count jobscountJobs | GET | Count the number of jobs for an entity with optional status stage filter |
Create a scheduled jobcreateScheduledJob | POST | Create a scheduled job |
Delete a scheduled jobdeleteScheduledJob | DELETE | Delete a scheduled job |
Duplicate a jobduplicateJob | POST | Duplicate an existing job, re-using its spec |
Get a jobgetJob | GET | Get a job |
Get a scheduled jobgetScheduledJob | GET | Get a scheduled job |
Get job hardwaregetJobHardware | GET | Get available job hardware |
List jobslistJobs | GET | List of jobs for an entity |
List scheduled jobslistScheduledJobs | GET | List scheduled jobs for an entity |
Resume a scheduled jobresumeScheduledJob | POST | Resume a scheduled job |
Run jobrunScheduledJobNow | POST | Trigger a scheduled job run. |
Start a jobstartJob | POST | Start a job |
Stream job eventsgetJobEvents | GET | Stream the events of a job, using SSE |
Stream job logsgetJobLogs | GET | Stream the logs of a job, using SSE |
Stream job metricsgetJobMetrics | GET | Stream the metrics of a job, using SSE |
Suspend a scheduled jobsuspendScheduledJob | POST | Suspend a scheduled job |
Update job exposed portsputJobsByNamespaceByJobIdExpose | PUT | Replace the exposed ports of a running job, applied live (no re-run). |
Update job labelsupdateJobLabels | PUT | Replace user-provided labels on a job |
Update job scheduleupdateJobSchedule | POST | Update job schedule |
Update scheduled job labelsupdateScheduledJobLabels | PUT | Replace user-provided labels on a scheduled job |
Kernels4
Duplicate xet filesduplicateKernelXetFiles | POST | Duplicate xet-stored files from this repo (source) into another repo (target) by xet hash, without re-uploading file bytes. |
Get kernelgetKernel | GET | Get kernel |
Get kernelgetKernelAtRevision | GET | Get kernel |
List kernelslistKernels | GET | List kernels with optional filtering, sorting, and pagination |
Models35
Add resource groupsetModelResourceGroup | POST | Add the repository to a resource group |
Batch handle access requestsbatchModelAccessRequests | POST | Accept, reject or reset to pending up to 100 access requests for a single gated repository in one call. |
Cancel access requestcancelModelAccessRequest | POST | Cancel the current user's access request to a gated repository |
Check upload methodpostModelsByNamespaceByRepoPreuploadByRev | POST | Check if a file should be uploaded through the Large File mechanism or directly. |
Create branchcreateModelBranch | POST | Create branch |
Create tagcreateModelTag | POST | Create tag |
Delete a branchdeleteModelBranch | DELETE | Delete a branch |
Delete a tagdeleteModelTag | DELETE | Delete a tag |
Delete Large filedeleteModelLfsFile | DELETE | Delete a Xet/LFS file |
Delete Large filesdeleteModelLfsFilesBatch | POST | Delete Xet/LFS files in batch |
Duplicate xet filesduplicateModelXetFiles | POST | Duplicate xet-stored files from this repo (source) into another repo (target) by xet hash, without re-uploading file bytes. |
Export access reportexportModelAccessReport | GET | Export a report of all access requests for a gated repository |
Generate JWTgetModelJwt | GET | Generate a JWT token for accessing a repository. |
Get a compare revcompareModelRevs | GET | Get a compare rev |
Get folder sizegetModelTreeSize | GET | Get the total size of a repository at a given revision, optionally under a specific subpath. |
Get model tagsgetModelTags | GET | Get all possible tags used for models, grouped by tag type. |
Get notebook URLgetModelNotebookUrl | GET | Get a jupyter notebook URL for the requested file |
Get resource groupgetModelResourceGroup | GET | Get resource group |
Get security statusgetModelSecurityScan | GET | Get the security status of a repo |
Get trendinggetTrending | GET | Get the trending repositories |
Grant accessgrantModelAccess | POST | Grant access to a user for a gated repository |
Handle access requesthandleModelAccessRequest | POST | Handle a user's access request to a gated repository |
List access requestslistModelAccessRequests | GET | List access requests for a gated repository |
List commitslistModelCommits | GET | List commits |
List folder contentlistModelTree | GET | List the content of a repository tree, with pagination support. |
List Large fileslistModelLfsFiles | GET | List Xet/LFS files for a repo |
List paths infolistModelPathsInfo | POST | List paths info |
List referenceslistModelRefs | GET | List references |
Request accessaskModelAccess | POST | Request access to a gated repository. |
Resolve a filegetResolveCacheModelsByNamespaceByRepoByRevByPath | GET | This endpoint requires to follow redirection |
Resolve a fileresolveModelFile | GET | This endpoint requires to follow redirection |
Squash refsuperSquashModel | POST | Squash all commits in the current ref into a single commit with the given message. |
Update repo settingsupdateModelSettings | PUT | Update the settings of a repo |
Xet read tokengetModelXetReadToken | GET | Get a read short-lived access token for XET |
Xet write tokengetModelXetWriteToken | GET | Get a write short-lived access token for XET upload |
Notifications5
Change read statusmarkNotificationsRead | POST | Mark discussions as read or unread. |
Delete notificationsdeleteNotifications | DELETE | Delete notifications, either by specifying discussionIds or by applying to all notifications with search parameters |
List notificationslistNotifications | GET | List notifications for the user |
Update notification settingsupdateNotificationSettings | PATCH | Update notification settings for the user |
Update watch settingsupdateWatchSettings | PATCH | Update watch settings for the user. |
Oauth4
Get user infogetOauthUserinfo | GET | Get information about the user. |
Get user infopostOauthUserinfo | POST | Get information about the user. |
Initiate device authorizationinitiateDeviceAuth | POST | Initiate device authorization |
Register a new OAuth appregisterOauthApp | POST | Register a new OAuth app |
Orgs14
Change member rolesetOrgMemberRole | PUT | Change the role of a member in the organization. |
Export the audit logexportOrgAuditLog | GET | Export the audit log events in JSON format for a Team or Enterprise organization. |
Get avatargetOrganizationsByNameAvatar | GET | Retrieve organization avatar. |
Get network security settingsgetOrgNetworkSecurity | GET | Get the network security settings for an organization. |
Get org usagegetOrgUsage | GET | Get org usage for a given period |
Get org usagegetOrganizationsByNameBillingUsage | GET | Get org usage for a given period |
Get organization memberslistOrgMembers | GET | Get a list of members for the organization with optional search and pagination. |
Get resource group usagegetOrgResourceGroupUsage | GET | Get org usage breakdown per resource group, returned as a time-series of monthly periods. |
Get session inference usagegetOrgInferenceUsage | GET | Get org inference-provider usage broken down per session id, as a time-series of monthly periods. |
Get social handlesgetOrgSocials | GET | Get an organization's social media handles |
List organization repositorieslistOrgRepos | GET | List organization repositories |
Revoke member tokenpostOrganizationsByNameSettingsTokensByTokenIdRevoke | POST | An org admin can revoke a token's access to the org. |
Stream usagegetOrganizationsByNameBillingUsageLive | GET | Get live usage for org |
Update network securityupdateOrgNetworkSecurity | PATCH | Update the network security settings for an organization. |
Papers7
Claim paper authorshipclaimPaperAuthorship | POST | Claim paper authorship |
Get a papergetPaper | GET | Get a paper |
Get Daily PaperslistDailyPapers | GET | Get Daily Papers |
Index a paperindexPaper | POST | Index a paper from arXiv by its ID. |
List paperslistPapers | GET | List arXiv papers sorted by published date |
Search paperssearchPapers | GET | Perform a hybrid semantic / full-text-search on papers |
Update paper linksupdatePaperLinks | POST | Update the project page, GitHub repository, or submitting organization for a paper. |
Repo Search2
Quick searchpostQuicksearch | POST | Quick search for models, datasets, spaces, orgs, users, papers, collections, and buckets |
Quick searchquickSearch | GET | Quick search for models, datasets, spaces, orgs, users, papers, collections, and buckets |
Repos3
Create a new repositorycreateRepo | POST | Create a new repository |
Duplicate a repositoryduplicateRepo | POST | Duplicate a repository |
Move repomoveRepo | POST | Move or rename a repo |
Repository28
Delete RepodeleteRepo | DELETE | |
Get DatasetgetDataset | GET | |
Get Dataset At RevisiongetDatasetAtRevision | GET | |
Get ModelgetModel | GET | |
Get Model At RevisiongetModelAtRevision | GET | |
Get Public DatasetgetPublicDataset | GET | Credential-free public variant pinned from the official huggingface hub client. |
Get Public Dataset At RevisiongetPublicDatasetAtRevision | GET | Credential-free public variant pinned from the official huggingface hub client. |
Get Public ModelgetPublicModel | GET | Credential-free public variant pinned from the official huggingface hub client. |
Get Public Model At RevisiongetPublicModelAtRevision | GET | Credential-free public variant pinned from the official huggingface hub client. |
Get Public SpacegetPublicSpace | GET | Credential-free public variant pinned from the official huggingface hub client. |
Get Public Space At RevisiongetPublicSpaceAtRevision | GET | Credential-free public variant pinned from the official huggingface hub client. |
Get SpacegetSpace | GET | |
Get Space At RevisiongetSpaceAtRevision | GET | |
List Dataset LikerslistDatasetLikers | GET | |
List DatasetslistDatasets | GET | |
List Model LikerslistModelLikers | GET | |
List ModelslistModels | GET | |
List Public Dataset LikerslistPublicDatasetLikers | GET | Credential-free public variant pinned from the official huggingface hub client. |
List Public DatasetslistPublicDatasets | GET | Credential-free public variant pinned from the official huggingface hub client. |
List Public Model LikerslistPublicModelLikers | GET | Credential-free public variant pinned from the official huggingface hub client. |
List Public ModelslistPublicModels | GET | Credential-free public variant pinned from the official huggingface hub client. |
List Public Space LikerslistPublicSpaceLikers | GET | Credential-free public variant pinned from the official huggingface hub client. |
List Public SpaceslistPublicSpaces | GET | Credential-free public variant pinned from the official huggingface hub client. |
List Space LikerslistSpaceLikers | GET | |
List SpaceslistSpaces | GET | |
Unlike DatasetunlikeDataset | DELETE | |
Unlike ModelunlikeModel | DELETE | |
Unlike SpaceunlikeSpace | DELETE |
Resource Groups9
Add usersaddResourceGroupUsers | POST | Add one or more organization members to a resource group. |
Change user rolechangeResourceGroupUserRole | PATCH | Change the role of a user in a resource group. |
Configure auto-joinconfigureResourceGroupAutoJoin | POST | Configure the auto-join settings of a resource group. |
Create resource groupcreateResourceGroup | POST | Create a new resource group in the organization. |
Delete resource groupdeleteResourceGroup | DELETE | Delete a resource group from the organization. |
Get resource groupgetResourceGroup | GET | Retrieve a single resource group by id. |
Get resource groupslistResourceGroups | GET | Retrieve accessible resource groups. |
Remove userremoveResourceGroupUser | DELETE | Remove a user from a resource group, revoking the access granted through it. |
Update resource groupupdateResourceGroup | PATCH | Update the name, description and/or monthly spend limits (in cents, null to remove) of a resource group. |
Scim28
Create a SCIM groupcreateScimGroup | POST | Creates a new group in the organization. |
Create a SCIM groupcreateScimProvisioningGroup | POST | Creates a new group in the organization. |
Create a SCIM usercreateScimUser | POST | Creates a new user in the organization. |
Create SCIM invitationcreateScimProvisioningUser | POST | Creates an invitation for a user to join the organization. |
Delete a SCIM groupdeleteScimGroup | DELETE | Delete a SCIM group |
Delete a SCIM groupdeleteScimProvisioningGroup | DELETE | Delete a SCIM group |
Delete a SCIM userdeleteScimUser | DELETE | Delete a SCIM user |
Delete SCIM userdeleteScimProvisioningUser | DELETE | Removes a user from the organization and deletes any pending invitations for non-managed organizations. |
Get a SCIM groupgetScimGroup | GET | Retrieves a group by its ID. |
Get a SCIM groupgetScimProvisioningGroup | GET | Retrieves a group by its ID. |
Get a SCIM provisioning usergetScimProvisioningUser | GET | Retrieves a SCIM user by their ID for non-managed organizations. |
Get a SCIM usergetScimUser | GET | Retrieves a SCIM user by their ID. |
Get SCIM ConfigurationgetScimConfig | GET | Returns the SCIM 2.0 Service Provider configuration, describing the server's capabilities and supported authentication schemes. |
Get SCIM Resource TypesgetScimResourceTypes | GET | Returns the list of SCIM 2.0 resource types supported by this server (User and Group). |
Get SCIM Schema by IDgetScimSchema | GET | Returns a single SCIM 2.0 schema definition by its schema URI. |
Get SCIM SchemasgetScimSchemas | GET | Returns the SCIM 2.0 schema definitions for User and Group resources. |
List SCIM groupslistScimGroups | GET | Get a list of SCIM groups. |
List SCIM groupslistScimProvisioningGroups | GET | Get a list of SCIM groups. |
List SCIM userslistScimUsers | GET | Retrieves a paginated list of all organization members who have been set up, including disabled users. |
List SCIM-managed userslistScimProvisioningUsers | GET | Retrieves a paginated list of organization members and pending invitations managed by SCIM for non-managed organizations. |
Update a SCIM groupreplaceScimGroup | PUT | Updates a group by its ID. |
Update a SCIM groupreplaceScimProvisioningGroup | PUT | Updates a group by its ID. |
Update a SCIM userreplaceScimProvisioningUser | PUT | Updates a provisioned user's invitation for non-managed organizations. |
Update a SCIM userreplaceScimUser | PUT | Updates a provisioned user, you'll need to provide all their information fresh - just like setting them up for the first time. |
Update SCIM grouppatchScimGroup | PATCH | Update attributes of a SCIM group. |
Update SCIM grouppatchScimProvisioningGroup | PATCH | Update attributes of a SCIM group. |
Update SCIM userpatchScimProvisioningUser | PATCH | Modify individual attributes for non-managed organizations. |
Update SCIM userpatchScimUser | PATCH | Update an attribute of a SCIM user. |
Service Accounts8
Create service accountcreateServiceAccount | POST | Create a new service account for the organization. |
Create service-account tokencreateServiceAccountToken | POST | Create a new access token for a service account. |
Delete service accountdeleteServiceAccount | DELETE | Delete a service account and all its tokens. |
Delete service-account tokendeleteServiceAccountToken | DELETE | Delete an access token from a service account. |
Get service accountgetServiceAccount | GET | Retrieve a single service account and its access token metadata. |
List service accountslistServiceAccounts | GET | List all service accounts for the organization. |
Rotate service-account tokenrotateServiceAccountToken | POST | Invalidate an existing token and generate a new one with the same permissions. |
Update service-account tokenupdateServiceAccountToken | PATCH | Update the name and/or permissions of an existing service account token. |
Spaces40
Add resource groupsetSpaceResourceGroup | POST | Add the repository to a resource group |
Check upload methodpostSpacesByNamespaceByRepoPreuploadByRev | POST | Check if a file should be uploaded through the Large File mechanism or directly. |
Create branchcreateSpaceBranch | POST | Create branch |
Create tagcreateSpaceTag | POST | Create tag |
Delete a branchdeleteSpaceBranch | DELETE | Delete a branch |
Delete a tagdeleteSpaceTag | DELETE | Delete a tag |
Delete Large filedeleteSpaceLfsFile | DELETE | Delete a Xet/LFS file |
Delete Large filesdeleteSpaceLfsFilesBatch | POST | Delete Xet/LFS files in batch |
Delete secretdeleteSpaceSecret | DELETE | Delete Spaces's secret |
Delete Space volumesdeleteSpaceVolumes | DELETE | Delete Space volumes |
Delete variabledeleteSpaceVariable | DELETE | Delete Spaces's variable |
Duplicate xet filesduplicateSpaceXetFiles | POST | Duplicate xet-stored files from this repo (source) into another repo (target) by xet hash, without re-uploading file bytes. |
Generate JWTgetSpaceJwt | GET | Generate a JWT token for accessing a repository. |
Get a compare revcompareSpaceRevs | GET | Get a compare rev |
Get folder sizegetSpaceTreeSize | GET | Get the total size of a repository at a given revision, optionally under a specific subpath. |
Get notebook URLgetSpaceNotebookUrl | GET | Get a jupyter notebook URL for the requested file |
Get resource groupgetSpaceResourceGroup | GET | Get resource group |
Get security statusgetSpaceSecurityScan | GET | Get the security status of a repo |
Get ZeroGPU quotagetZeroGpuQuota | GET | Get the authenticated user's current ZeroGPU quota usage and limits |
List commitslistSpaceCommits | GET | List commits |
List folder contentlistSpaceTree | GET | List the content of a repository tree, with pagination support. |
List Large fileslistSpaceLfsFiles | GET | List Xet/LFS files for a repo |
List paths infolistSpacePathsInfo | POST | List paths info |
List referenceslistSpaceRefs | GET | List references |
List secretslistSpaceSecrets | GET | List a Space's secret keys. |
List space hardwarelistSpaceHardware | GET | Get available space hardware |
List Space templateslistSpaceTemplates | GET | Returns the catalog of official Space templates. |
List variableslistSpaceVariables | GET | List a Space's variables with their values. |
Resolve a filegetResolveCacheSpacesByNamespaceByRepoByRevByPath | GET | This endpoint requires to follow redirection |
Resolve a fileresolveSpaceFile | GET | This endpoint requires to follow redirection |
Set Space volumessetSpaceVolumes | PUT | Set Space volumes |
Squash refsuperSquashSpace | POST | Squash all commits in the current ref into a single commit with the given message. |
Stream eventsstreamSpaceEvents | GET | Get status updates for a specific Space in a streaming fashion, with SSE protocol |
Stream logsgetSpaceLogs | GET | Get logs for a specific Space in a streaming fashion, with SSE protocol |
Stream metricsgetSpaceMetrics | GET | Get live metrics for a specific Space in a streaming fashion, with SSE protocol, such as current Zero-GPU usage |
Update repo settingsupdateSpaceSettings | PUT | Update the settings of a repo |
Upsert secretupsertSpaceSecret | POST | Upsert Spaces's secret |
Upsert variableupsertSpaceVariable | POST | Upsert Spaces's variable |
Xet read tokengetSpaceXetReadToken | GET | Get a read short-lived access token for XET |
Xet write tokengetSpaceXetWriteToken | GET | Get a write short-lived access token for XET upload |
Sql Console3
Create embedcreateSqlConsoleEmbed | POST | Create SQL Console embed |
Delete embeddeleteSqlConsoleEmbed | DELETE | Delete SQL Console embed |
Update embedupdateSqlConsoleEmbed | PATCH | Update SQL Console embed |
Tokens1
Revoke leaked tokenspostCredentialsRevoke | POST | Publicly invalidate leaked Hugging Face access tokens. |
Users14
Get avatargetAvatarsByNamespace | GET | Display the avatar for any user or organization. |
Get jobs usagegetMyJobsUsage | GET | Get user Jobs usage for current subscription period |
Get MCP toolsgetMyMcpTools | GET | Get the MCP tools for the current user |
Get session inference usagegetMyInferenceUsage | GET | Get user inference-provider usage broken down per session id |
Get social handlesgetUserSocials | GET | Get a user's social media handles |
Get user usagegetMyUsage | GET | Get user usage for a given period |
Get user usagegetSettingsBillingUsage | GET | Get user usage for a given period |
List user likeslistUserLikes | GET | List public repos liked by a user |
List user repositorieslistMyRepos | GET | List user repositories |
Retrieve user avatargetUserAvatar | GET | This endpoint returns a JSON with the avatar URL for the user. |
Stream metricsgetSettingsMetricsLive | GET | Get live usage and running jobs count for the logged-in user, over a single SSE connection |
Stream usagegetSettingsBillingUsageLive | GET | Get live usage for user |
Stream usagegetUsersByUsernameBillingUsageLive | GET | Get live usage for user |
User overviewgetUserOverview | GET | User overview |
Webhooks7
Create webhookcreateWebhook | POST | Create webhook |
Delete webhookdeleteWebhook | DELETE | Delete webhook |
Enable/disable webhooktoggleWebhook | POST | Enable/disable webhook |
Get webhookgetWebhook | GET | Get webhook |
List webhookslistWebhooks | GET | List webhooks |
Replay webhook logreplayWebhookLog | POST | Replay webhook log |
Update webhookupdateWebhook | POST | Update webhook |