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

# Undeploy a Tool API

[Back to API List](https://koreai.mintlify.site/agent-platform/v1/apis.md)

This API undeploys a tool that's deployed in an environment.

The API response includes the tool ID, dock status ID and the tool undeployment status. After receiving the response, use the `dockStatusId` to call the [Get Dock Status API](https://koreai.mintlify.site/agent-platform/v1/apis/apis-list/get-dock-status) and verify the status of the task.

| Method | POST |
| :- | :- |
| Endpoint | `https://{host}/api/public/tools/:{toolId}/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](https://koreai.mintlify.site/agent-platform/v1/apis.md#how-to-create-the-api-key).

## Path Parameters

| PARAMETER | DESCRIPTION | TYPE | REQUIRED/OPTIONAL |
| :- | :- | :- | :- |
| host | The environment URL. For example, `https://agent-platform.domain.ai/` | String | Required |
| toolId | The unique identifier of the tool being undeployed. | String | Required |

## Sample Request

```js theme={null}
curl --location --request POST 'https://{host}/api/public/tools/a-0xxxxxxxxxxxxxxxxxxe/undeploy' \
--header 'x-api-key: kg-axxxxxxx-5xx3-5xx8-bxxb-9xxxxxxxxxx-ebxxxxxxxxxxx3'
```

## Body Parameters

No parameters are passed.

## Sample Response

```js theme={null}
{
   "dockStatusId": "ds-exxxxxx7-2xx8-5xxc-axx7-cxx73xxxxxx1",
   "toolId": "a-4xxxxxx9-fxx9-5xx7-axx7-9xxfdxxxxxxb",
   "jobType": "TOOLS",
   "action": "UNDEPLOY",
   "status": "SUCCESS"
}
```

## Response Parameters

| PARAMETER | DESCRIPTION | TYPE |
| :- | :- | :- |
| dockStatusId | The unique identifier for tracking the tool undeployment status. | String |
| toolId | The unique identifier of the tool being undeployed. | String |
| jobType | The type of job being performed (`TOOLS`). | String |
| action | The action being performed (`UNDEPLOY`). | String |
| status | The undeployment status (`SUCCESS`, "*IN\_PROGRESS*", or `FAILED`). | String |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.