---
title: "Switch the model on a deployment (deprecated path)"
method: POST
path: "/v1/instances/{instanceId}/switch-model"
tags: ["Deprecated"]
deprecated: true
---

# Switch the model on a deployment (deprecated path)

`POST /v1/instances/{instanceId}/switch-model`

## Request

- Base URL: `https://api.auxen.ai`
- URL: `https://api.auxen.ai/v1/instances/{instanceId}/switch-model`
- Auth: HTTP bearer

> **Deprecated.**

Deprecated alias of `POST /v1/deployments/{deploymentId}/switch-model`; works until 2027-04-02. Returns the pre-2026 `status` values and error codes, with the new values in `deployment_status` and `renamed_to`, plus every new field name alongside the old one. Responses include `Deprecation`, `Sunset`, and `Link` headers. See https://auxen.ai/docs/api/migration.

## Path parameters

- `instanceId` string, required

## Request body

- object
  - `model` string, required

## Response `202`

Accepted — switch started.

## Other responses

- `400`: Plan mismatch or invalid model.
- `404`: Resource not found.
- `409`: Conflict with current resource state.

---

[API](https://skmtc.dev/auxen/apis/auxen-headless-api.md) · [All operations](https://skmtc.dev/auxen/apis/auxen-headless-api/llms.txt) · [OpenAPI document](https://skmtc.dev/auxen/apis/auxen-headless-api/revisions/164be65f5ce8?raw)