Hugging Face

Hugging Face Endpoints API

Manage dedicated inference endpoints

GitHub OpenAPI
Business capability
Artificial Intelligence Management BC-610.60

Operations 10

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /endpoint/{namespace} List Inference Endpoints in a namespace · List All Endpoints #
Ask an LLM
“Which Inference Endpoints are running under my account or organization?”
“Can I see every dedicated endpoint my team has deployed?”
Tell an agent
List all Inference Endpoints in namespace {namespace}.
Show me the endpoints my organization {namespace} has deployed.
POST /endpoint/{namespace} Deploy a new Inference Endpoint · Create a New Endpoint #
Ask an LLM
“How do I deploy a model as a dedicated Inference Endpoint on Hugging Face?”
“Can I pick the cloud provider and hardware when I create an endpoint?”
Tell an agent
Create an Inference Endpoint named {name} in {namespace} serving {model} on {compute} from {provider} with security type {type}.
Deploy {model} to a new {type} endpoint called {name} under {namespace} using {provider} hardware {compute}.
GET /endpoint/{namespace}/{endpoint_name} Get an Inference Endpoint's details · Get Endpoint Details #
Ask an LLM
“What is the current status and URL of one of my Inference Endpoints?”
“Which model and hardware is a specific endpoint configured with?”
Tell an agent
Get the details of endpoint {endpoint_name} in {namespace}.
Check the status of Inference Endpoint {endpoint_name} owned by {namespace}.
PUT /endpoint/{namespace}/{endpoint_name} Change an endpoint's model, hardware or scaling · Update an Endpoint #
Ask an LLM
“Can I swap the model on an existing endpoint without recreating it?”
“Is it possible to move a running endpoint to bigger hardware or change its autoscaling?”
Tell an agent
Update endpoint {endpoint_name} in {namespace} to serve {model}.
Change the compute settings of {endpoint_name} under {namespace} to {compute}.
DELETE /endpoint/{namespace}/{endpoint_name} Permanently delete an Inference Endpoint · Delete an Endpoint #
Ask an LLM
“Can I permanently remove an endpoint and everything attached to it?”
“What happens to an endpoint's resources when I delete it rather than pause it?”
Tell an agent destructive · confirm first
Delete Inference Endpoint {endpoint_name} from {namespace}.
Permanently tear down endpoint {endpoint_name} in namespace {namespace}.
POST /endpoint/{namespace}/{endpoint_name}/pause Pause an endpoint to stop compute costs · Pause an Endpoint #
Ask an LLM
“Can I stop paying for an endpoint's compute but keep its configuration for later?”
“Is there a way to put an endpoint on hold until I resume it manually?”
Tell an agent
Pause endpoint {endpoint_name} in {namespace}.
Stop billing on {endpoint_name} under {namespace} by pausing it.
POST /endpoint/{namespace}/{endpoint_name}/resume Resume a paused endpoint · Resume an Endpoint #
Ask an LLM
“How do I bring a paused Inference Endpoint back online?”
“Can I restart an endpoint I paused earlier with the same configuration?”
Tell an agent
Resume paused endpoint {endpoint_name} in {namespace}.
Bring {endpoint_name} under {namespace} back online.
POST /endpoint/{namespace}/{endpoint_name}/scale-to-zero Scale an endpoint down to zero replicas · Scale Endpoint to Zero #
Ask an LLM
“Can I scale an endpoint to zero replicas so it wakes up again when traffic arrives?”
“What is the difference between scaling to zero and pausing when autoscaling is on?”
Tell an agent
Scale endpoint {endpoint_name} in {namespace} to zero replicas.
Drop {endpoint_name} under {namespace} to zero and let traffic scale it back up.
GET /endpoint/{namespace}/{endpoint_name}/logs Read an endpoint's runtime logs · Get Endpoint Logs #
Ask an LLM
“Where can I see the runtime logs to debug why my endpoint is failing?”
“Can I pull the container logs of a specific Inference Endpoint?”
Tell an agent
Get the runtime logs for endpoint {endpoint_name} in {namespace}.
Show me recent log output from {endpoint_name} under {namespace}.
GET /endpoint/{namespace}/{endpoint_name}/metrics Get an endpoint's traffic and latency metrics · Get Endpoint Metrics #
Ask an LLM
“How many requests is my endpoint handling, and what are its latencies?”
“Can I check the error rate of an Inference Endpoint?”
Tell an agent
Get performance metrics for endpoint {endpoint_name} in {namespace}.
Show request counts, latency and errors for {endpoint_name} under {namespace}.

Documentation

📖
Documentation
https://huggingface.co/docs/api-inference/index
📖
Authentication
https://huggingface.co/docs/api-inference/quicktour#authentication
📖
GettingStarted
https://huggingface.co/docs/api-inference/quicktour
📖
RateLimits
https://huggingface.co/docs/api-inference/en/rate-limits
📖
Documentation
https://huggingface.co/docs/hub/api
📖
Authentication
https://huggingface.co/docs/hub/security-tokens
📖
RateLimits
https://huggingface.co/docs/hub/en/rate-limits
📖
Documentation
https://huggingface.co/docs/inference-endpoints/api_reference
📖
GettingStarted
https://huggingface.co/docs/inference-endpoints/index
📖
Documentation
https://huggingface.co/docs/inference-providers/en/index
📖
APIReference
https://huggingface.co/docs/inference-providers/en/tasks/index
📖
GettingStarted
https://huggingface.co/docs/inference-providers/en/guides/first-api-call
📖
Documentation
https://huggingface.co/docs/dataset-viewer/index
📖
GettingStarted
https://huggingface.co/docs/dataset-viewer/en/quick_start
📖
Documentation
https://huggingface.co/docs/text-generation-inference/en/index
📖
APIReference
https://huggingface.co/docs/text-generation-inference/en/reference/api_reference
📖
GettingStarted
https://huggingface.co/docs/text-generation-inference/quicktour
📖
Documentation
https://huggingface.co/docs/text-generation-inference/en/messages_api

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/hugging-face/refs/heads/main/openapi/hugging-face-endpoints-api-openapi.yml

SDKs

📦
GitHubRepository
https://github.com/huggingface/dataset-viewer
📦
GitHubRepository
https://github.com/huggingface/text-generation-inference

Other Resources

🔗
FAQ
https://huggingface.co/docs/api-inference/faq
🔗
SDKs
https://huggingface.co/docs/huggingface_hub/index
🔗
SDKs
https://huggingface.co/docs/huggingface.js/hub/README
🔗
Pricing
https://huggingface.co/pricing#inference-endpoints
🔗
Pricing
https://huggingface.co/docs/inference-providers/pricing
🔗
Models
https://huggingface.co/inference/models

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/hugging-face:hugging-face-endpoints-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

hugging-face-endpoints-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Hugging Face Inference Endpoints API
  description: Deploy and scale machine learning models with dedicated, secure infrastructure. Manage Inference Endpoints programmatically - create, update, scale, pause, resume, and delete dedicated endpoints for serving ML models with autoscaling and custom hardware configurations.
  version: 1.0.0
  termsOfService: https://huggingface.co/terms-of-service
  contact:
    name: Hugging Face Support
    url: https://huggingface.co/support
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0
servers:
- url: https://api.endpoints.huggingface.cloud/v2
  description: Hugging Face Inference Endpoints management API
security:
- bearerAuth: []
tags:


# --- truncated at 32 KB (35 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/hugging-face/refs/heads/main/openapi/hugging-face-endpoints-api-openapi.yml