> ## Documentation Index
> Fetch the complete documentation index at: https://koreai.mintlify.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Undeploy a Model API

<Badge icon="arrow-left" color="gray">[Back to API List](/ai-for-process/apis/apis)</Badge>

This API undeploys a model from the environment. The API response includes the model ID, model undeployment status, and the dockStatusId. After receiving the response, use the `dockStatusId` to call the [Get Dock Status API](/ai-for-process/apis/apis-list/get-dock-status) and verify successful model undeployment.

| **Method**        | POST                                                   |
| ----------------- | ------------------------------------------------------ |
| **Endpoint**      | `https://{host}/api/public/models/:{modelId}/undeploy` |
| **Content Type**  | application/json                                       |
| **Authorization** | **`X-api-key`** – The API key used for authentication. |

**Where can I find the API key?**

To use the API, you will need an API key. [Learn more](/ai-for-process/workflows/triggers-and-access#create-an-api-key).

## Path Parameters

| **PARAMETER** | **DESCRIPTION**                                                       | **TYPE** | **REQUIRED/OPTIONAL** |
| ------------- | --------------------------------------------------------------------- | -------- | --------------------- |
| **host**      | The environment URL. For example, `https://ai-for-process.domain.ai/` | String   | Required              |
| **modelId**   | The unique identifier of the model to deploy.                         | String   | Required              |

## Sample Request

```js theme={null}
curl --location --request POST 'https://{host}/api/public/models/cm-20xxxxxf-0xx9-5xx0-8xx1-81xxxxxxxx80/undeploy' 
--header 'x-api-key: kg-axxxxxxx-xxx-5xx8-bxxb-9xxxxxxxxxx-ebxxxxxx-5xxb-4xxb-9xx5-cxxxxxxxxx3'
```

## Body Parameters

No parameters are passed.

## Sample Response

```js theme={null}
{
  "dock-statusId": "ds-d0xxxxxd-bxx9-5xx0-8xx5-5bxxxxxxxxx1",
  "modelId": "cm-77xxxxxb-exx9-5xxc-8xx6-52xxxxxxxxx1",
  "jobType": "MODELS",
  "action": "UNDEPLOY",
  "status": "SUCCESS"
}
```

## Response Parameters

| **PARAMETER**    | **DESCRIPTION**                                                        | **TYPE** |
| ---------------- | ---------------------------------------------------------------------- | -------- |
| **dockStatusId** | The unique identifier to track the model undeployment status.          | String   |
| **modelId**      | The unique identifier for the model.                                   | String   |
| **jobType**      | Type of job being performed (`MODELS`).                                | String   |
| **action**       | The action performed on the model, i.e. `UNDEPLOY`.                    | String   |
| **status**       | The current status of the job (`SUCCESS`, `IN_PROGRESS`, or `FAILED`). | String   |