---
title: "Updates the HuggingFace source behind a deployed model's alias."
method: POST
path: "/projects/{project_id}/foundry/deployed-models/update"
tags: ["Foundry"]
---

# Updates the HuggingFace source behind a deployed model's alias.

`POST /projects/{project_id}/foundry/deployed-models/update`

## Path parameters

- `project_id` string, required

## Request body

- UpdateModelRequest
  - `model_alias` string, required — Customer-facing alias of the model to update.
  - `new_hugging_face_model` string, required — New HuggingFace model to point the alias at.
  - `region` string — Region in which to perform the update. If omitted, all regions are updated.
  - `run_candidate_test` boolean — Whether to run a candidate health-check before switching the source.

## Response `202`

- UpdateModelResponse
  - `workflows` UpdateResponseEntry[] — The per-cluster update workflows that were triggered.
    - `cluster_name` string — Name of the cluster the workflow runs on.
    - `error` string — Error message, if the workflow could not be started.
    - `region` string — Region of the cluster.
    - `run_id` string — Temporal run ID.
    - `status` string — Status of the triggered workflow.
    - `workflow_id` string — Temporal workflow ID.

## Other responses

- `400` — Error Bad Request
- `401` — Error Authentication Failed
- `403` — Error Permissions
- `404` — Error Not Found
- `500` — Error Internal Server

---

[API](https://skmtc.net/crusoecloud/apis/crusoe-cloud-api-gateway.md) · [All operations](https://skmtc.net/crusoecloud/apis/crusoe-cloud-api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/crusoecloud/crusoe-cloud-api-gateway/versions/a3fd2dedc72b/schema)