---
title: "Update model endpoint"
method: PUT
path: "/models/{modelName}"
tags: ["models"]
---

# Update model endpoint

`PUT /models/{modelName}`

Updates a model gateway endpoint's configuration. Changes to provider settings or integration connection take effect immediately.

## Request body

- Model — Gateway endpoint to external LLM provider APIs (OpenAI, Anthropic, etc.) with unified access control, credentials management, and usage tracking.
  - `events` CoreEvent[] — Events happening on a resource deployed on Blaxel
    - `canaryRevision` string — Canary revisionID link to the event
    - `message` string — Event message
    - `revision` string — RevisionID link to the event
    - `status` string — Event status
    - `time` string — Event time
    - `type` string — Event type
  - `metadata` Metadata, required — Owner fields for Persistence
    - `createdAt` string — The date and time when the resource was created
    - `updatedAt` string — The date and time when the resource was updated
    - `createdBy` string — The user or service account who created the resource
    - `updatedBy` string — The user or service account who updated the resource
    - `displayName` string — Human-readable name for display in the UI. Can contain spaces and special characters, max 63 characters.
    - `externalId` string — Caller-owned identifier for external lookups. Max 64 chars, alphanumeric + dash.
    - `labels` MetadataLabels — Key-value pairs for organizing and filtering resources. Labels can be used to categorize resources by environment, project, team, or any custom taxonomy.
    - `name` string, required — Unique identifier for the resource within the workspace. Must be lowercase alphanumeric with hyphens, max 49 characters. Immutable after creation.
    - `plan` string — Billing plan tier applied to this resource (inherited from workspace account)
    - `url` string — Auto-generated endpoint URL for accessing this resource (for agents, functions, models, sandboxes)
    - `workspace` string — Name of the workspace this resource belongs to (read-only, set automatically)
  - `spec` ModelSpec, required — Configuration for a model gateway endpoint including provider type, credentials, and access policies
    - `enabled` boolean — When false, the model endpoint is disabled and will not accept inference requests
    - `flavors` Flavor[] — Types of hardware available for deployments
      - `name` string — Flavor name (e.g. t4)
      - `type` 'cpu' | 'gpu' — Flavor type (e.g. cpu, gpu)
    - `integrationConnections` string[]
    - `policies` string[]
    - `runtime` ModelRuntime — Configuration identifying which external LLM provider and model this gateway endpoint proxies to
      - `endpointName` string — Provider-specific endpoint name (e.g., HuggingFace Inference Endpoints name)
      - `generation` 'mk3' | 'mk2' — Infrastructure generation. Empty (default) uses the classic deployment path. mk3 deploys through the model-gateway on microVM clusters.
      - `model` string — Model identifier at the provider (e.g., gpt-4.1, claude-sonnet-4-20250514, mistral-large-latest)
      - `organization` string — Organization or account identifier at the provider (required for some providers like OpenAI)
      - `type` 'hf_private_endpoint' | 'hf_public_endpoint' | 'huggingface' | 'public_model' | 'mcp' | 'openai' | 'anthropic' | 'gemini' | 'mistral' | 'deepseek' | 'cohere' | 'cerebras' | 'xai' | 'vertexai' | 'azure-openai-service' | 'azure-ai-inference' | 'azure-marketplace' | 'groq' — LLM provider type determining the API protocol and authentication method
    - `sandbox` boolean — When true, uses sandbox/test credentials from the integration connection
  - `status` 'DELETING' | 'TERMINATED' | 'FAILED' | 'DEACTIVATED' | 'DEACTIVATING' | 'UPLOADING' | 'BUILDING' | 'DEPLOYING' | 'DEPLOYED' | 'BUILT' — Deployment status of a resource deployed on Blaxel

## Response `200`

successful operation

- Model — Gateway endpoint to external LLM provider APIs (OpenAI, Anthropic, etc.) with unified access control, credentials management, and usage tracking.
  - `events` CoreEvent[] — Events happening on a resource deployed on Blaxel
    - `canaryRevision` string — Canary revisionID link to the event
    - `message` string — Event message
    - `revision` string — RevisionID link to the event
    - `status` string — Event status
    - `time` string — Event time
    - `type` string — Event type
  - `metadata` Metadata, required — Owner fields for Persistence
    - `createdAt` string — The date and time when the resource was created
    - `updatedAt` string — The date and time when the resource was updated
    - `createdBy` string — The user or service account who created the resource
    - `updatedBy` string — The user or service account who updated the resource
    - `displayName` string — Human-readable name for display in the UI. Can contain spaces and special characters, max 63 characters.
    - `externalId` string — Caller-owned identifier for external lookups. Max 64 chars, alphanumeric + dash.
    - `labels` MetadataLabels — Key-value pairs for organizing and filtering resources. Labels can be used to categorize resources by environment, project, team, or any custom taxonomy.
    - `name` string, required — Unique identifier for the resource within the workspace. Must be lowercase alphanumeric with hyphens, max 49 characters. Immutable after creation.
    - `plan` string — Billing plan tier applied to this resource (inherited from workspace account)
    - `url` string — Auto-generated endpoint URL for accessing this resource (for agents, functions, models, sandboxes)
    - `workspace` string — Name of the workspace this resource belongs to (read-only, set automatically)
  - `spec` ModelSpec, required — Configuration for a model gateway endpoint including provider type, credentials, and access policies
    - `enabled` boolean — When false, the model endpoint is disabled and will not accept inference requests
    - `flavors` Flavor[] — Types of hardware available for deployments
      - `name` string — Flavor name (e.g. t4)
      - `type` 'cpu' | 'gpu' — Flavor type (e.g. cpu, gpu)
    - `integrationConnections` string[]
    - `policies` string[]
    - `runtime` ModelRuntime — Configuration identifying which external LLM provider and model this gateway endpoint proxies to
      - `endpointName` string — Provider-specific endpoint name (e.g., HuggingFace Inference Endpoints name)
      - `generation` 'mk3' | 'mk2' — Infrastructure generation. Empty (default) uses the classic deployment path. mk3 deploys through the model-gateway on microVM clusters.
      - `model` string — Model identifier at the provider (e.g., gpt-4.1, claude-sonnet-4-20250514, mistral-large-latest)
      - `organization` string — Organization or account identifier at the provider (required for some providers like OpenAI)
      - `type` 'hf_private_endpoint' | 'hf_public_endpoint' | 'huggingface' | 'public_model' | 'mcp' | 'openai' | 'anthropic' | 'gemini' | 'mistral' | 'deepseek' | 'cohere' | 'cerebras' | 'xai' | 'vertexai' | 'azure-openai-service' | 'azure-ai-inference' | 'azure-marketplace' | 'groq' — LLM provider type determining the API protocol and authentication method
    - `sandbox` boolean — When true, uses sandbox/test credentials from the integration connection
  - `status` 'DELETING' | 'TERMINATED' | 'FAILED' | 'DEACTIVATED' | 'DEACTIVATING' | 'UPLOADING' | 'BUILDING' | 'DEPLOYING' | 'DEPLOYED' | 'BUILT' — Deployment status of a resource deployed on Blaxel

## Other responses

- `400` — Bad request - Invalid model configuration
- `401` — Unauthorized - Invalid or missing authentication credentials
- `403` — Forbidden - Insufficient permissions to update this model
- `404` — Not found - Model does not exist
- `500` — Internal server error

---

[API](https://skmtc.net/blaxel/apis/blaxel-control-plane.md) · [All operations](https://skmtc.net/blaxel/apis/blaxel-control-plane/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/blaxel/blaxel-control-plane/revisions/dfa264bc72ee/schema)