Hugging Face

Delete bucket via DELETE /api/buckets/{namespace}/{repo}

Delete a discussion via DELETE /api/{repoType}/{namespace}/{repo}/discussions/{num}

Delete PR ref -- Deletes the git ref for a closed/merged pull request to free up storage. LFS files unique to this PR will be garbage collected. The PR page and diff will still be viewable using stored commit data. via DELETE /api/{repoType}/{namespace}/{repo}/discussions/{num}/ref

Delete embed -- Delete SQL Console embed via DELETE /api/{repoType}/{namespace}/{repo}/sql-console/embed/{id}

Delete a collection via DELETE /api/collections/{namespace}/{slug}

Delete item -- Delete an item from a collection via DELETE /api/collections/{namespace}/{slug}/items/{slug}

Delete a branch via DELETE /api/datasets/{namespace}/{repo}/branch/{rev}

Delete Large file -- Delete a Xet/LFS file via DELETE /api/datasets/{namespace}/{repo}/lfs-files/{sha}

Delete a tag via DELETE /api/datasets/{namespace}/{repo}/tag/{rev}

Delete a branch via DELETE /api/models/{namespace}/{repo}/branch/{rev}

Delete Large file -- Delete a Xet/LFS file via DELETE /api/models/{namespace}/{repo}/lfs-files/{sha}

Delete a tag via DELETE /api/models/{namespace}/{repo}/tag/{rev}

Delete notifications -- Delete notifications, either by specifying discussionIds or by applying to all notifications with search parameters via DELETE /api/notifications

Delete resource group -- Delete a resource group from the organization. Requires the org to have a Team plan or higher. via DELETE /api/organizations/{name}/resource-groups/{resourceGroupId}

Remove user -- Remove a user from a resource group, revoking the access granted through it. Requires the org to have a Team plan or higher. via DELETE /api/organizations/{name}/resource-groups/{resourceGroupId}/users/{username}

Delete a SCIM group via DELETE /api/organizations/{name}/scim-provisioning/v2/Groups/{groupId}

Delete SCIM user -- Removes a user from the organization and deletes any pending invitations for non-managed organizations. via DELETE /api/organizations/{name}/scim-provisioning/v2/Users/{userId}

Delete a SCIM group via DELETE /api/organizations/{name}/scim/v2/Groups/{groupId}

Delete a SCIM user via DELETE /api/organizations/{name}/scim/v2/Users/{userId}

Delete service account -- Delete a service account and all its tokens. This action cannot be undone. via DELETE /api/organizations/{name}/service-accounts/{serviceAccountId}

Delete service-account token -- Delete an access token from a service account. This action cannot be undone. via DELETE /api/organizations/{name}/service-accounts/{serviceAccountId}/tokens/{tokenId}

Delete a discussion via DELETE /api/posts/{username}/{postSlug}

Delete a scheduled job via DELETE /api/scheduled-jobs/{namespace}/{jobId}

Delete webhook via DELETE /api/settings/webhooks/{webhookId}

Delete a branch via DELETE /api/spaces/{namespace}/{repo}/branch/{rev}

Delete Large file -- Delete a Xet/LFS file via DELETE /api/spaces/{namespace}/{repo}/lfs-files/{sha}

Delete secret -- Delete Spaces's secret via DELETE /api/spaces/{namespace}/{repo}/secrets

Delete a tag via DELETE /api/spaces/{namespace}/{repo}/tag/{rev}

Delete variable -- Delete Spaces's variable via DELETE /api/spaces/{namespace}/{repo}/variables

Delete Space volumes via DELETE /api/spaces/{namespace}/{repo}/volumes

Get agent harnesses -- Get the registry of AI agents / harnesses known to the Hub, along with the standard environment variables used to detect them. Clients use this registry to identify which agent they are running in when reporting Hub activity. via GET /api/agent-harnesses

Get health via GET /api/agentic/provisioning/health

Get a resource by ID via GET /api/agentic/provisioning/resources/{id}

Get services via GET /api/agentic/provisioning/services

Get avatar -- Display the avatar for any user or organization. This endpoint redirects to the avatar URL for either a user or an organization via GET /api/avatars/{namespace}

List namespace buckets via GET /api/buckets/{namespace}

Get bucket details via GET /api/buckets/{namespace}/{repo}

Get resource group via GET /api/buckets/{namespace}/{repo}/resource-group

List files via GET /api/buckets/{namespace}/{repo}/tree/{path}

Xet read token -- Get a read short-lived access token for XET via GET /api/buckets/{namespace}/{repo}/xet-read-token

Xet write token -- Get a write short-lived access token for XET upload via GET /api/buckets/{namespace}/{repo}/xet-write-token

List discussions -- Get discussions for a repo via GET /api/{repoType}/{namespace}/{repo}/discussions

Get discussion details via GET /api/{repoType}/{namespace}/{repo}/discussions/{num}

PR storage estimate -- Estimates the LFS storage used by a PR that could be freed if the ref is deleted. via GET /api/{repoType}/{namespace}/{repo}/discussions/{num}/storage

Duplication status via GET /api/{repoType}/{namespace}/{repo}/duplicate/status

Get collections via GET /api/collections

Get a collection via GET /api/collections/{namespace}/{slug}

Get collection resource group via GET /api/collections/{namespace}/{slug}/resource-group

Get Daily Papers via GET /api/daily_papers

List commits via GET /api/datasets/{namespace}/{repo}/commits/{rev}

Get a compare rev via GET /api/datasets/{namespace}/{repo}/compare/{compare}

Generate JWT -- Generate a JWT token for accessing a repository. Supports optional write access for spaces in dev mode, custom expiration, and encryption. via GET /api/datasets/{namespace}/{repo}/jwt

Get dataset leaderboard -- Returns the evaluation results ranked by score for a dataset/task via GET /api/datasets/{namespace}/{repo}/leaderboard

List Large files -- List Xet/LFS files for a repo via GET /api/datasets/{namespace}/{repo}/lfs-files

Get notebook URL -- Get a jupyter notebook URL for the requested file via GET /api/datasets/{namespace}/{repo}/notebook/{rev}/{path}

List references via GET /api/datasets/{namespace}/{repo}/refs

Get resource group via GET /api/datasets/{namespace}/{repo}/resource-group

Get security status -- Get the security status of a repo via GET /api/datasets/{namespace}/{repo}/scan

List folder content -- List the content of a repository tree, with pagination support. via GET /api/datasets/{namespace}/{repo}/tree/{rev}/{path}

Get folder size -- Get the total size of a repository at a given revision, optionally under a specific subpath. Returns the total size in bytes of all files under the specified path (recursively). If a file is stored via Xet/LFS, the LFS file size is used. via GET /api/datasets/{namespace}/{repo}/treesize/{rev}/{path}

List access requests -- List access requests for a gated repository via GET /api/datasets/{namespace}/{repo}/user-access-request/{status}

Xet read token -- Get a read short-lived access token for XET via GET /api/datasets/{namespace}/{repo}/xet-read-token/{rev}

Xet write token -- Get a write short-lived access token for XET upload via GET /api/datasets/{namespace}/{repo}/xet-write-token/{rev}

Get dataset tags -- Get all possible tags used for datasets, grouped by tag type. Optionally restrict to only one tag type via GET /api/datasets-tags-by-type

List docs -- Get list of available documentation via GET /api/docs

Search docs -- Search any Hugging Face documentation via GET /api/docs/search

Full-text search docs -- Full-text search across Hugging Face documentation via GET /api/docs/search/full-text

List jobs -- List of jobs for an entity via GET /api/jobs/{namespace}

Get a job via GET /api/jobs/{namespace}/{jobId}

Stream job events -- Stream the events of a job, using SSE via GET /api/jobs/{namespace}/{jobId}/events

Stream job logs -- Stream the logs of a job, using SSE via GET /api/jobs/{namespace}/{jobId}/logs

Stream job metrics -- Stream the metrics of a job, using SSE via GET /api/jobs/{namespace}/{jobId}/metrics

Count jobs -- Count the number of jobs for an entity with optional status stage filter via GET /api/jobs/{namespace}/count

Get job hardware -- Get available job hardware via GET /api/jobs/hardware

List kernels -- List kernels with optional filtering, sorting, and pagination via GET /api/kernels

Get kernel via GET /api/kernels/{namespace}/{repo}

Get kernel via GET /api/kernels/{namespace}/{repo}/revision/{rev}

List commits via GET /api/models/{namespace}/{repo}/commits/{rev}

Get a compare rev via GET /api/models/{namespace}/{repo}/compare/{compare}

Generate JWT -- Generate a JWT token for accessing a repository. Supports optional write access for spaces in dev mode, custom expiration, and encryption. via GET /api/models/{namespace}/{repo}/jwt

List Large files -- List Xet/LFS files for a repo via GET /api/models/{namespace}/{repo}/lfs-files

Get notebook URL -- Get a jupyter notebook URL for the requested file via GET /api/models/{namespace}/{repo}/notebook/{rev}/{path}

List references via GET /api/models/{namespace}/{repo}/refs

Get resource group via GET /api/models/{namespace}/{repo}/resource-group

Get security status -- Get the security status of a repo via GET /api/models/{namespace}/{repo}/scan

List folder content -- List the content of a repository tree, with pagination support. via GET /api/models/{namespace}/{repo}/tree/{rev}/{path}

Get folder size -- Get the total size of a repository at a given revision, optionally under a specific subpath. Returns the total size in bytes of all files under the specified path (recursively). If a file is stored via Xet/LFS, the LFS file size is used. via GET /api/models/{namespace}/{repo}/treesize/{rev}/{path}

List access requests -- List access requests for a gated repository via GET /api/models/{namespace}/{repo}/user-access-request/{status}

Xet read token -- Get a read short-lived access token for XET via GET /api/models/{namespace}/{repo}/xet-read-token/{rev}

Xet write token -- Get a write short-lived access token for XET upload via GET /api/models/{namespace}/{repo}/xet-write-token/{rev}

Get model tags -- Get all possible tags used for models, grouped by tag type. Optionally restrict to only one tag type via GET /api/models-tags-by-type

List notifications -- List notifications for the user via GET /api/notifications

Export the audit log -- Export the audit log events in JSON format for a Team or Enterprise organization. The export is limited to the last 100,000 events. via GET /api/organizations/{name}/audit-log/export

Get avatar -- Retrieve organization avatar. This endpoint returns a JSON with the avatar URL for the organization. If called with the `Sec-Fetch-Dest: image` header, it instead redirects to the avatar URL via GET /api/organizations/{name}/avatar

Get org usage -- Get org usage for a given period via GET /api/organizations/{name}/billing/usage

Get session inference usage -- Get org inference-provider usage broken down per session id, as a time-series of monthly periods. via GET /api/organizations/{name}/billing/usage-by-inference-session

Get resource group usage -- Get org usage breakdown per resource group, returned as a time-series of monthly periods. Window is [startDate, endDate], defaults to the current month. Both dates must fall within the last 12 months. Storage values are the peak observed within each monthly period. via GET /api/organizations/{name}/billing/usage-by-resource-group

Stream usage -- Get live usage for org via GET /api/organizations/{name}/billing/usage/live

Get org usage -- Get org usage for a given period via GET /api/organizations/{name}/billing/usage-v2

Get organization members -- Get a list of members for the organization with optional search and pagination. via GET /api/organizations/{name}/members

Get resource groups -- Retrieve accessible resource groups. Get all resource groups the user has access to. Requires the org to have a Team plan or higher. via GET /api/organizations/{name}/resource-groups

Get resource group -- Retrieve a single resource group by id. Requires the org to have a Team plan or higher. via GET /api/organizations/{name}/resource-groups/{resourceGroupId}

List SCIM groups -- Get a list of SCIM groups. Retrieves a paginated list of all organization groups. If you provide the filter parameter, the resources for all matching groups are returned. via GET /api/organizations/{name}/scim-provisioning/v2/Groups

Get a SCIM group -- Retrieves a group by its ID. If you provide the `excludedAttributes` parameter, the `members` attribute is not returned. via GET /api/organizations/{name}/scim-provisioning/v2/Groups/{groupId}

List SCIM-managed users -- Retrieves a paginated list of organization members and pending invitations managed by SCIM for non-managed organizations. via GET /api/organizations/{name}/scim-provisioning/v2/Users

Get a SCIM provisioning user -- Retrieves a SCIM user by their ID for non-managed organizations. via GET /api/organizations/{name}/scim-provisioning/v2/Users/{userId}

List SCIM groups -- Get a list of SCIM groups. Retrieves a paginated list of all organization groups. If you provide the filter parameter, the resources for all matching groups are returned. via GET /api/organizations/{name}/scim/v2/Groups

Get a SCIM group -- Retrieves a group by its ID. If you provide the `excludedAttributes` parameter, the `members` attribute is not returned. via GET /api/organizations/{name}/scim/v2/Groups/{groupId}

Get SCIM Resource Types -- Returns the list of SCIM 2.0 resource types supported by this server (User and Group). via GET /api/organizations/{name}/scim/v2/ResourceTypes

Get SCIM Schemas -- Returns the SCIM 2.0 schema definitions for User and Group resources. via GET /api/organizations/{name}/scim/v2/Schemas

Get SCIM Schema by ID -- Returns a single SCIM 2.0 schema definition by its schema URI. via GET /api/organizations/{name}/scim/v2/Schemas/{schemaId}

Get SCIM Configuration -- Returns the SCIM 2.0 Service Provider configuration, describing the server's capabilities and supported authentication schemes. via GET /api/organizations/{name}/scim/v2/ServiceProviderConfig

List SCIM users -- Retrieves a paginated list of all organization members who have been set up, including disabled users. If you provide the filter parameter, the resources for all matching members are returned. via GET /api/organizations/{name}/scim/v2/Users

Get a SCIM user -- Retrieves a SCIM user by their ID. via GET /api/organizations/{name}/scim/v2/Users/{userId}

List service accounts -- List all service accounts for the organization. via GET /api/organizations/{name}/service-accounts

Get service account -- Retrieve a single service account and its access token metadata. Token secrets are never returned. via GET /api/organizations/{name}/service-accounts/{serviceAccountId}

Get network security settings -- Get the network security settings for an organization. via GET /api/organizations/{name}/settings/network-security

List organization repositories via GET /api/organizations/{name}/settings/repositories

List member access tokens -- List the access tokens of the organization's members. Team or Enterprise only. via GET /api/organizations/{name}/settings/tokens

Get social handles -- Get an organization's social media handles via GET /api/organizations/{name}/socials

List papers -- List arXiv papers sorted by published date via GET /api/papers

Get a paper via GET /api/papers/{paperId}

Search papers -- Perform a hybrid semantic / full-text-search on papers via GET /api/papers/search

Quick search -- Quick search for models, datasets, spaces, orgs, users, papers, collections, and buckets via GET /api/quicksearch

Registry token -- Mints a short-lived EdDSA JWT for the HuggingFace container registry, verifiable via the JWK at `/api/keys/jwt`. via GET /api/registry/token

Resolve a file -- This endpoint requires to follow redirection via GET /api/resolve-cache/datasets/{namespace}/{repo}/{rev}/{path}

Resolve a file -- This endpoint requires to follow redirection via GET /api/resolve-cache/models/{namespace}/{repo}/{rev}/{path}

Resolve a file -- This endpoint requires to follow redirection via GET /api/resolve-cache/spaces/{namespace}/{repo}/{rev}/{path}

List scheduled jobs -- List scheduled jobs for an entity via GET /api/scheduled-jobs/{namespace}

Get a scheduled job via GET /api/scheduled-jobs/{namespace}/{jobId}

Get user usage -- Get user usage for a given period via GET /api/settings/billing/usage

Get session inference usage -- Get user inference-provider usage broken down per session id via GET /api/settings/billing/usage-by-inference-session

Get jobs usage -- Get user Jobs usage for current subscription period via GET /api/settings/billing/usage/jobs

Stream usage -- Get live usage for user via GET /api/settings/billing/usage/live

Get user usage -- Get user usage for a given period via GET /api/settings/billing/usage-v2

Get MCP tools -- Get the MCP tools for the current user via GET /api/settings/mcp

Stream metrics -- Get live usage and running jobs count for the logged-in user, over a single SSE connection via GET /api/settings/metrics/live

List user repositories via GET /api/settings/repositories

List webhooks via GET /api/settings/webhooks

Get webhook via GET /api/settings/webhooks/{webhookId}

List commits via GET /api/spaces/{namespace}/{repo}/commits/{rev}

Get a compare rev via GET /api/spaces/{namespace}/{repo}/compare/{compare}

Stream events -- Get status updates for a specific Space in a streaming fashion, with SSE protocol via GET /api/spaces/{namespace}/{repo}/events

Generate JWT -- Generate a JWT token for accessing a repository. Supports optional write access for spaces in dev mode, custom expiration, and encryption. via GET /api/spaces/{namespace}/{repo}/jwt

List Large files -- List Xet/LFS files for a repo via GET /api/spaces/{namespace}/{repo}/lfs-files

Stream logs -- Get logs for a specific Space in a streaming fashion, with SSE protocol via GET /api/spaces/{namespace}/{repo}/logs/{logType}

Stream metrics -- Get live metrics for a specific Space in a streaming fashion, with SSE protocol, such as current Zero-GPU usage via GET /api/spaces/{namespace}/{repo}/metrics

Get notebook URL -- Get a jupyter notebook URL for the requested file via GET /api/spaces/{namespace}/{repo}/notebook/{rev}/{path}

List references via GET /api/spaces/{namespace}/{repo}/refs

Get resource group via GET /api/spaces/{namespace}/{repo}/resource-group

Get security status -- Get the security status of a repo via GET /api/spaces/{namespace}/{repo}/scan

List secrets -- List a Space's secret keys. Values are never returned. via GET /api/spaces/{namespace}/{repo}/secrets

List folder content -- List the content of a repository tree, with pagination support. via GET /api/spaces/{namespace}/{repo}/tree/{rev}/{path}

Get folder size -- Get the total size of a repository at a given revision, optionally under a specific subpath. Returns the total size in bytes of all files under the specified path (recursively). If a file is stored via Xet/LFS, the LFS file size is used. via GET /api/spaces/{namespace}/{repo}/treesize/{rev}/{path}

List variables -- List a Space's variables with their values. via GET /api/spaces/{namespace}/{repo}/variables

Xet read token -- Get a read short-lived access token for XET via GET /api/spaces/{namespace}/{repo}/xet-read-token/{rev}

Xet write token -- Get a write short-lived access token for XET upload via GET /api/spaces/{namespace}/{repo}/xet-write-token/{rev}

List space hardware -- Get available space hardware via GET /api/spaces/hardware

List Space templates -- Returns the catalog of official Space templates. The `repoId` of a template can be passed as `template` when creating a Space through the create-repo endpoint. via GET /api/spaces/templates

Get ZeroGPU quota -- Get the authenticated user's current ZeroGPU quota usage and limits via GET /api/spaces/zero-gpu/quota

Get trending -- Get the trending repositories via GET /api/trending

Retrieve user avatar -- This endpoint returns a JSON with the avatar URL for the user. If called with the `Sec-Fetch-Dest: image` header, it instead redirects to the avatar URL via GET /api/users/{username}/avatar

Stream usage -- Get live usage for user via GET /api/users/{username}/billing/usage/live

List user followers via GET /api/users/{username}/followers

List followed users via GET /api/users/{username}/following

List followed organizations via GET /api/users/{username}/following/orgs

List user likes -- List public repos liked by a user via GET /api/users/{username}/likes

User overview via GET /api/users/{username}/overview

Get social handles -- Get a user's social media handles via GET /api/users/{username}/socials

Get user info -- Get information about the user and auth method used via GET /api/whoami-v2

Get file metadata -- Returns file metadata including size, hash, and links to XET authentication via GET /buckets/{namespace}/{repo}/resolve/{path}

Resolve a file -- This endpoint requires to follow redirection via GET /{namespace}/{repo}/resolve/{rev}/{path}

Export access report -- Export a report of all access requests for a gated repository via GET /{namespace}/{repo}/user-access-report

Resolve a file -- This endpoint requires to follow redirection via GET /datasets/{namespace}/{repo}/resolve/{rev}/{path}

Export access report -- Export a report of all access requests for a gated repository via GET /datasets/{namespace}/{repo}/user-access-report

Get user info -- Get information about the user. Only available through oauth access tokens. Information varies depending on the scope of the oauth app and what permissions the user granted to the oauth app. via GET /oauth/userinfo

Resolve a file -- This endpoint requires to follow redirection via GET /spaces/{namespace}/{repo}/resolve/{rev}/{path}

Update embed -- Update SQL Console embed via PATCH /api/{repoType}/{namespace}/{repo}/sql-console/embed/{id}

Update a collection via PATCH /api/collections/{namespace}/{slug}

Update item -- Update an item in a collection via PATCH /api/collections/{namespace}/{slug}/items/{slug}

Update resource group -- Update the name, description and/or monthly spend limits (in cents, `null` to remove) of a resource group. `spendLimits.total` caps the group's combined spend across every product; the per-product limits cap each product on top of it. Requires the org to have a Team plan or higher. via PATCH /api/organizations/{name}/resource-groups/{resourceGroupId}

Change user role -- Change the role of a user in a resource group. Requires the org to have a Team plan or higher. via PATCH /api/organizations/{name}/resource-groups/{resourceGroupId}/users/{username}

Update SCIM group -- Update attributes of a SCIM group. Updates individual attributes using Operations format. Just provide the changes you want to make using add, remove (only `members` is supported), or replace operations. via PATCH /api/organizations/{name}/scim-provisioning/v2/Groups/{groupId}

Update SCIM user -- Modify individual attributes for non-managed organizations. Only the `active` field can be modified. User profile fields are not editable via SCIM. via PATCH /api/organizations/{name}/scim-provisioning/v2/Users/{userId}

Update SCIM group -- Update attributes of a SCIM group. Updates individual attributes using Operations format. Just provide the changes you want to make using add, remove (only `members` is supported), or replace operations. via PATCH /api/organizations/{name}/scim/v2/Groups/{groupId}

Update SCIM user -- Update an attribute of a SCIM user. Modify individual attributes using Operations format. Just provide the changes you want to make using add, remove (only `externalId` is supported), or replace operations. If you set `active` to `false`, the user will be deprovisioned from the organization. Complicated SCIM `path` values are not supported like `emails[type eq 'work'].value`. via PATCH /api/organizations/{name}/scim/v2/Users/{userId}

Update service-account token -- Update the name and/or permissions of an existing service account token. via PATCH /api/organizations/{name}/service-accounts/{serviceAccountId}/tokens/{tokenId}

Update network security -- Update the network security settings for an organization. via PATCH /api/organizations/{name}/settings/network-security

Update notification settings -- Update notification settings for the user via PATCH /api/settings/notifications

Update watch settings -- Update watch settings for the user. Get notified when discussions happen on your watched items. via PATCH /api/settings/watch

Create account request via POST /api/agentic/provisioning/account_requests

Create deep link via POST /api/agentic/provisioning/deep_links

Provision a resource via POST /api/agentic/provisioning/resources

Remove resource via POST /api/agentic/provisioning/resources/{id}/remove

Rotate resource credentials via POST /api/agentic/provisioning/resources/{id}/rotate_credentials

Update resource service via POST /api/agentic/provisioning/resources/{id}/update_service

Create a new comment via POST /api/blog/{namespace}/{slug}/comment

Create a new comment via POST /api/blog/{namespace}/{slug}/comment/{commentId}/reply

Create a new comment via POST /api/blog/{slug}/comment

Create a new comment via POST /api/blog/{slug}/comment/{commentId}/reply

Create bucket via POST /api/buckets/{namespace}/{repo}

Batch file operations -- Accepts NDJSON (newline-delimited JSON) where each line is an addFile, copyFile, or deleteFile instruction. All add/copy operations must come before all delete operations. JSON-lines payload: ```json '{"type":"addFile","path":"...","xetHash":"...","mtime":...,"mtimeNanos":...,"contentType":"..."}' + '{"type":"copyFile","path":"...","xetHash":"...","sourceRepoType":"...","sourceRepoId":"...","mtime":...,"mtimeNanos":...,"contentType":"..."}' + '{"type":"deleteFile","path":"..."}' ``` via POST /api/buckets/{namespace}/{repo}/batch

Duplicate xet files -- Duplicate xet-stored files from this repo (source) into another repo (target) by xet hash, without re-uploading file bytes. The caller must then commit the files with their sha256/size as usual. via POST /api/buckets/{namespace}/{repo}/lfs-files/duplicate

List paths info via POST /api/buckets/{namespace}/{repo}/paths-info

Add resource group -- Add the repository to a resource group via POST /api/buckets/{namespace}/{repo}/resource-group

Create a new discussion via POST /api/{repoType}/{namespace}/{repo}/discussions

Create a new comment via POST /api/{repoType}/{namespace}/{repo}/discussions/{num}/comment

Merge a pull request via POST /api/{repoType}/{namespace}/{repo}/discussions/{num}/merge

Pin a discussion via POST /api/{repoType}/{namespace}/{repo}/discussions/{num}/pin

Change status -- Change the status of a discussion via POST /api/{repoType}/{namespace}/{repo}/discussions/{num}/status

Change title -- Change the title of a discussion via POST /api/{repoType}/{namespace}/{repo}/discussions/{num}/title

Duplicate a repository via POST /api/{repoType}/{namespace}/{repo}/duplicate

Create embed -- Create SQL Console embed via POST /api/{repoType}/{namespace}/{repo}/sql-console/embed

Create a collection via POST /api/collections

Add item -- Add an item to a collection via POST /api/collections/{namespace}/{slug}/items

Batch update items -- Batch update items in a collection via POST /api/collections/{namespace}/{slug}/items/batch

Set collection resource group -- Assign, move, or unassign an organization-owned collection to a resource group. Pass null to unassign. User-owned collections are not eligible. via POST /api/collections/{namespace}/{slug}/resource-group

Revoke leaked tokens -- Publicly invalidate leaked Hugging Face access tokens. Possession of the raw token value is the only proof required: no authentication is needed, and no rights over the owning account or org are necessary. Each raw token is fully invalidated, the owning user is notified by email. Always returns 202, whether or not any of the provided tokens existed, so the response cannot be used to probe token validity. via POST /api/credentials/revoke

Create branch via POST /api/datasets/{namespace}/{repo}/branch/{rev}

Commit -- For legacy reason, we support both `application/json` and `application/x-ndjson` but we recommend using `application/x-ndjson` to create a commit. JSON-lines payload: ```json { "key": "header", "value": { "summary": "string (REQUIRED)", "description": "string (OPTIONAL - defaults to empty string)", "parentCommit": "string (OPTIONAL - 40-character hex SHA)" } } { "key": "file", "value": { "path": "string (REQUIRED)", "content": "string (OPTIONAL - required if oldPath not set)", "encoding": "utf-8 | base64 (OPTIONAL - defaults to utf-8)", "oldPath": "string (OPTIONAL - for move/rename operations)" } } { "key": "deletedEntry", "value": { "path": "string (REQUIRED)" } } { "key": "lfsFile", "value": { "path": "string (REQUIRED - max 1000 chars)", "oid": "string (OPTIONAL - required if oldPath not set, 64 hex chars)", "algo": "sha256 (OPTIONAL - only sha256 supported)", "size": "number (OPTIONAL - required if oldPath is set)", "oldPath": "string (OPTIONAL - for move/rename operations)" } } ``` JSON payload: ```json { "summary": "string (REQUIRED)", "description": "string (OPTIONAL - defaults to empty string)", "parentCommit": "string (OPTIONAL - 40-character hex SHA)" "files": [ { "path": "string (REQUIRED)", "content": "string (OPTIONAL - required if oldPath not set)", "encoding": "utf-8 | base64 (OPTIONAL - defaults to utf-8)", "oldPath": "string (OPTIONAL - for move/rename operations)" } ], "deletedEntries": [ { "path": "string (REQUIRED)" } ], "lfsFiles": [ { "path": "string (REQUIRED - max 1000 chars)", "oid": "string (OPTIONAL - required if oldPath not set, 64 hex chars)", "algo": "sha256 (OPTIONAL - only sha256 supported)", "size": "number (OPTIONAL - required if oldPath is set)", "oldPath": "string (OPTIONAL - for move/rename operations)" } ] } ``` via POST /api/datasets/{namespace}/{repo}/commit/{rev}

Delete Large files -- Delete Xet/LFS files in batch via POST /api/datasets/{namespace}/{repo}/lfs-files/batch

Duplicate xet files -- Duplicate xet-stored files from this repo (source) into another repo (target) by xet hash, without re-uploading file bytes. The caller must then commit the files with their sha256/size as usual. via POST /api/datasets/{namespace}/{repo}/lfs-files/duplicate

List paths info via POST /api/datasets/{namespace}/{repo}/paths-info/{rev}

Check upload method -- Check if a file should be uploaded through the Large File mechanism or directly. via POST /api/datasets/{namespace}/{repo}/preupload/{rev}

Add resource group -- Add the repository to a resource group via POST /api/datasets/{namespace}/{repo}/resource-group

Squash ref -- Squash all commits in the current ref into a single commit with the given message. Action is irreversible. via POST /api/datasets/{namespace}/{repo}/super-squash/{rev}

Create tag via POST /api/datasets/{namespace}/{repo}/tag/{rev}

Batch handle access requests -- Accept, reject or reset to pending up to 100 access requests for a single gated repository in one call. The same `status` (and optional `rejectionReason`) is applied to every request in the list. via POST /api/datasets/{namespace}/{repo}/user-access-request/batch

Cancel access request -- Cancel the current user's access request to a gated repository via POST /api/datasets/{namespace}/{repo}/user-access-request/cancel

Grant access -- Grant access to a user for a gated repository via POST /api/datasets/{namespace}/{repo}/user-access-request/grant

Handle access request -- Handle a user's access request to a gated repository via POST /api/datasets/{namespace}/{repo}/user-access-request/handle

Check access -- Check if the user has access to the inference endpoint via POST /api/inference-endpoints/{namespace}/auth-check/{perms}

Check access -- Check if the user has access to the inference endpoint via POST /api/inference-endpoints/{namespace}/{endpoint}/auth-check/{perms}

Start a job via POST /api/jobs/{namespace}

Check access -- Check if the user has access to jobs in the namespace via POST /api/jobs/{namespace}/auth-check/{perms}

Check access -- Check if the user has access to jobs in the namespace via POST /api/jobs/{namespace}/{jobId}/auth-check/{perms}

Cancel a job via POST /api/jobs/{namespace}/{jobId}/cancel

Duplicate a job -- Duplicate an existing job, re-using its spec via POST /api/jobs/{namespace}/{jobId}/duplicate

Duplicate xet files -- Duplicate xet-stored files from this repo (source) into another repo (target) by xet hash, without re-uploading file bytes. The caller must then commit the files with their sha256/size as usual. via POST /api/kernels/{namespace}/{repo}/lfs-files/duplicate

Create branch via POST /api/models/{namespace}/{repo}/branch/{rev}

Commit -- For legacy reason, we support both `application/json` and `application/x-ndjson` but we recommend using `application/x-ndjson` to create a commit. JSON-lines payload: ```json { "key": "header", "value": { "summary": "string (REQUIRED)", "description": "string (OPTIONAL - defaults to empty string)", "parentCommit": "string (OPTIONAL - 40-character hex SHA)" } } { "key": "file", "value": { "path": "string (REQUIRED)", "content": "string (OPTIONAL - required if oldPath not set)", "encoding": "utf-8 | base64 (OPTIONAL - defaults to utf-8)", "oldPath": "string (OPTIONAL - for move/rename operations)" } } { "key": "deletedEntry", "value": { "path": "string (REQUIRED)" } } { "key": "lfsFile", "value": { "path": "string (REQUIRED - max 1000 chars)", "oid": "string (OPTIONAL - required if oldPath not set, 64 hex chars)", "algo": "sha256 (OPTIONAL - only sha256 supported)", "size": "number (OPTIONAL - required if oldPath is set)", "oldPath": "string (OPTIONAL - for move/rename operations)" } } ``` JSON payload: ```json { "summary": "string (REQUIRED)", "description": "string (OPTIONAL - defaults to empty string)", "parentCommit": "string (OPTIONAL - 40-character hex SHA)" "files": [ { "path": "string (REQUIRED)", "content": "string (OPTIONAL - required if oldPath not set)", "encoding": "utf-8 | base64 (OPTIONAL - defaults to utf-8)", "oldPath": "string (OPTIONAL - for move/rename operations)" } ], "deletedEntries": [ { "path": "string (REQUIRED)" } ], "lfsFiles": [ { "path": "string (REQUIRED - max 1000 chars)", "oid": "string (OPTIONAL - required if oldPath not set, 64 hex chars)", "algo": "sha256 (OPTIONAL - only sha256 supported)", "size": "number (OPTIONAL - required if oldPath is set)", "oldPath": "string (OPTIONAL - for move/rename operations)" } ] } ``` via POST /api/models/{namespace}/{repo}/commit/{rev}

Delete Large files -- Delete Xet/LFS files in batch via POST /api/models/{namespace}/{repo}/lfs-files/batch

Duplicate xet files -- Duplicate xet-stored files from this repo (source) into another repo (target) by xet hash, without re-uploading file bytes. The caller must then commit the files with their sha256/size as usual. via POST /api/models/{namespace}/{repo}/lfs-files/duplicate

List paths info via POST /api/models/{namespace}/{repo}/paths-info/{rev}

Check upload method -- Check if a file should be uploaded through the Large File mechanism or directly. via POST /api/models/{namespace}/{repo}/preupload/{rev}

Add resource group -- Add the repository to a resource group via POST /api/models/{namespace}/{repo}/resource-group

Squash ref -- Squash all commits in the current ref into a single commit with the given message. Action is irreversible. via POST /api/models/{namespace}/{repo}/super-squash/{rev}

Create tag via POST /api/models/{namespace}/{repo}/tag/{rev}

Batch handle access requests -- Accept, reject or reset to pending up to 100 access requests for a single gated repository in one call. The same `status` (and optional `rejectionReason`) is applied to every request in the list. via POST /api/models/{namespace}/{repo}/user-access-request/batch

Cancel access request -- Cancel the current user's access request to a gated repository via POST /api/models/{namespace}/{repo}/user-access-request/cancel

Grant access -- Grant access to a user for a gated repository via POST /api/models/{namespace}/{repo}/user-access-request/grant

Handle access request -- Handle a user's access request to a gated repository via POST /api/models/{namespace}/{repo}/user-access-request/handle

Change read status -- Mark discussions as read or unread. If `applyToAll` is true, all notifications for the user matching the search parameters will be marked as read or unread. via POST /api/notifications/mark-as-read

Create resource group -- Create a new resource group in the organization. Requires the org to have a Team plan or higher. via POST /api/organizations/{name}/resource-groups

Configure auto-join -- Configure the auto-join settings of a resource group. Requires the org to have a Team plan or higher. via POST /api/organizations/{name}/resource-groups/{resourceGroupId}/settings

Add users -- Add one or more organization members to a resource group. Requires the org to have a Team plan or higher. via POST /api/organizations/{name}/resource-groups/{resourceGroupId}/users

Create a SCIM group -- Creates a new group in the organization. The group name must be unique within the organization. via POST /api/organizations/{name}/scim-provisioning/v2/Groups

Create SCIM invitation -- Creates an invitation for a user to join the organization. The user must have an existing Hugging Face account. via POST /api/organizations/{name}/scim-provisioning/v2/Users

Create a SCIM group -- Creates a new group in the organization. The group name must be unique within the organization. via POST /api/organizations/{name}/scim/v2/Groups

Create a SCIM user -- Creates a new user in the organization. If the user already exists, only `active` field will be updated to provision the user. via POST /api/organizations/{name}/scim/v2/Users

Create service account -- Create a new service account for the organization. via POST /api/organizations/{name}/service-accounts

Create service-account token -- Create a new access token for a service account. Store the token securely - it cannot be retrieved later. via POST /api/organizations/{name}/service-accounts/{serviceAccountId}/tokens

Rotate service-account token -- Invalidate an existing token and generate a new one with the same permissions. The old token will stop working immediately. via POST /api/organizations/{name}/service-accounts/{serviceAccountId}/tokens/{tokenId}/rotate

Revoke member token -- An org admin can revoke a token's access to the org. The token itself isn't deleted, it still works outside the org. The token id is the one displayed in the org token settings page or through the tokens listing API endpoint. Enterprise only. via POST /api/organizations/{name}/settings/tokens/{tokenId}/revoke

Create a new comment via POST /api/papers/{paperId}/comment

Create a new comment via POST /api/papers/{paperId}/comment/{commentId}/reply

Update paper links -- Update the project page, GitHub repository, or submitting organization for a paper. Requires the requester to be the paper author, the Daily Papers submitter, or a papers admin. via POST /api/papers/{paperId}/links

Index a paper -- Index a paper from arXiv by its ID. If the paper is already indexed, only its authors can re-index it. via POST /api/papers/index

Create a new comment via POST /api/posts/{username}/{postSlug}/comment

Create a new comment via POST /api/posts/{username}/{postSlug}/comment/{commentId}/reply

Quick search -- Quick search for models, datasets, spaces, orgs, users, papers, collections, and buckets via POST /api/quicksearch

Create a new repository via POST /api/repos/create

Move repo -- Move or rename a repo via POST /api/repos/move

Create a scheduled job via POST /api/scheduled-jobs/{namespace}

Resume a scheduled job via POST /api/scheduled-jobs/{namespace}/{jobId}/resume

Run job -- Trigger a scheduled job run. Trigger a scheduled job to run immediately. Throws an error if an instance is already running and job spec does not allow concurrent runs. via POST /api/scheduled-jobs/{namespace}/{jobId}/run

Update job schedule via POST /api/scheduled-jobs/{namespace}/{jobId}/schedule

Suspend a scheduled job via POST /api/scheduled-jobs/{namespace}/{jobId}/suspend

Claim paper authorship via POST /api/settings/papers/claim

Create webhook via POST /api/settings/webhooks

Update webhook via POST /api/settings/webhooks/{webhookId}

Enable/disable webhook via POST /api/settings/webhooks/{webhookId}/{action}

Replay webhook log via POST /api/settings/webhooks/{webhookId}/replay/{logId}

Create branch via POST /api/spaces/{namespace}/{repo}/branch/{rev}

Commit -- For legacy reason, we support both `application/json` and `application/x-ndjson` but we recommend using `application/x-ndjson` to create a commit. JSON-lines payload: ```json { "key": "header", "value": { "summary": "string (REQUIRED)", "description": "string (OPTIONAL - defaults to empty string)", "parentCommit": "string (OPTIONAL - 40-character hex SHA)" } } { "key": "file", "value": { "path": "string (REQUIRED)", "content": "string (OPTIONAL - required if oldPath not set)", "encoding": "utf-8 | base64 (OPTIONAL - defaults to utf-8)", "oldPath": "string (OPTIONAL - for move/rename operations)" } } { "key": "deletedEntry", "value": { "path": "string (REQUIRED)" } } { "key": "lfsFile", "value": { "path": "string (REQUIRED - max 1000 chars)", "oid": "string (OPTIONAL - required if oldPath not set, 64 hex chars)", "algo": "sha256 (OPTIONAL - only sha256 supported)", "size": "number (OPTIONAL - required if oldPath is set)", "oldPath": "string (OPTIONAL - for move/rename operations)" } } ``` JSON payload: ```json { "summary": "string (REQUIRED)", "description": "string (OPTIONAL - defaults to empty string)", "parentCommit": "string (OPTIONAL - 40-character hex SHA)" "files": [ { "path": "string (REQUIRED)", "content": "string (OPTIONAL - required if oldPath not set)", "encoding": "utf-8 | base64 (OPTIONAL - defaults to utf-8)", "oldPath": "string (OPTIONAL - for move/rename operations)" } ], "deletedEntries": [ { "path": "string (REQUIRED)" } ], "lfsFiles": [ { "path": "string (REQUIRED - max 1000 chars)", "oid": "string (OPTIONAL - required if oldPath not set, 64 hex chars)", "algo": "sha256 (OPTIONAL - only sha256 supported)", "size": "number (OPTIONAL - required if oldPath is set)", "oldPath": "string (OPTIONAL - for move/rename operations)" } ] } ``` via POST /api/spaces/{namespace}/{repo}/commit/{rev}

Delete Large files -- Delete Xet/LFS files in batch via POST /api/spaces/{namespace}/{repo}/lfs-files/batch

Duplicate xet files -- Duplicate xet-stored files from this repo (source) into another repo (target) by xet hash, without re-uploading file bytes. The caller must then commit the files with their sha256/size as usual. via POST /api/spaces/{namespace}/{repo}/lfs-files/duplicate

List paths info via POST /api/spaces/{namespace}/{repo}/paths-info/{rev}

Check upload method -- Check if a file should be uploaded through the Large File mechanism or directly. via POST /api/spaces/{namespace}/{repo}/preupload/{rev}

Add resource group -- Add the repository to a resource group via POST /api/spaces/{namespace}/{repo}/resource-group

Upsert secret -- Upsert Spaces's secret via POST /api/spaces/{namespace}/{repo}/secrets

Squash ref -- Squash all commits in the current ref into a single commit with the given message. Action is irreversible. via POST /api/spaces/{namespace}/{repo}/super-squash/{rev}

Create tag via POST /api/spaces/{namespace}/{repo}/tag/{rev}

Upsert variable -- Upsert Spaces's variable via POST /api/spaces/{namespace}/{repo}/variables

Request access -- Request access to a gated repository. The fields requested by repository card metadata (https://huggingface.co/docs/hub/en/models-gated#customize-requested-information) via POST /{namespace}/{repo}/ask-access

Request access -- Request access to a gated repository. The fields requested by repository card metadata (https://huggingface.co/docs/hub/en/models-gated#customize-requested-information) via POST /datasets/{namespace}/{repo}/ask-access

Initiate device authorization via POST /oauth/device

Register a new OAuth app via POST /oauth/register

Get user info -- Get information about the user. Only available through oauth access tokens. Information varies depending on the scope of the oauth app and what permissions the user granted to the oauth app. via POST /oauth/userinfo

Update bucket settings via PUT /api/buckets/{namespace}/{repo}/settings

Update repo settings -- Update the settings of a repo via PUT /api/datasets/{namespace}/{repo}/settings

Update job exposed ports -- Replace the exposed ports of a running job, applied live (no re-run). Ports listed in `portsPublic` are reachable without any authentication. via PUT /api/jobs/{namespace}/{jobId}/expose

Update job labels -- Replace user-provided labels on a job via PUT /api/jobs/{namespace}/{jobId}/labels

Update repo settings -- Update the settings of a repo via PUT /api/models/{namespace}/{repo}/settings

Change member role -- Change the role of a member in the organization. Need a paid plan. via PUT /api/organizations/{name}/members/{username}/role

Update a SCIM group -- Updates a group by its ID. The group name must be unique within the organization. via PUT /api/organizations/{name}/scim-provisioning/v2/Groups/{groupId}

Update a SCIM user -- Updates a provisioned user's invitation for non-managed organizations. User profile fields are not editable via SCIM for non-managed organizations. via PUT /api/organizations/{name}/scim-provisioning/v2/Users/{userId}

Update a SCIM group -- Updates a group by its ID. The group name must be unique within the organization. via PUT /api/organizations/{name}/scim/v2/Groups/{groupId}

Update a SCIM user -- Updates a provisioned user, you'll need to provide all their information fresh - just like setting them up for the first time. Any details you don't include will be automatically removed, so make sure to include everything they need to keep their account running smoothly. Setting `active` to `false` will deprovision the user from the organization. via PUT /api/organizations/{name}/scim/v2/Users/{userId}

Rotate SSO credentials -- Update SSO credentials of the organization's SSO configuration. SSO stays enabled and does not need to be re-tested, so rotation causes no downtime. Requires a paid plan. via PUT /api/organizations/{name}/settings/sso/credentials

Update scheduled job labels -- Replace user-provided labels on a scheduled job via PUT /api/scheduled-jobs/{namespace}/{jobId}/labels

Update repo settings -- Update the settings of a repo via PUT /api/spaces/{namespace}/{repo}/settings

Set Space volumes via PUT /api/spaces/{namespace}/{repo}/volumes