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

# Delete Workflow Tool

<span class="badge--delete">DELETE</span> <code class="endpoint-url">/workflows/:id/tools/:toolId</code>

Remove a custom tool. By default this **soft-disables** it (`is_active: false`) so past calls stay in history; pass `?hard=true` to permanently delete the row.

## Path Parameters

| Parameter | Type          | Required | Description |
| --------- | ------------- | -------- | ----------- |
| `id`      | string (uuid) | **Yes**  | Agent ID    |
| `toolId`  | string (uuid) | **Yes**  | Tool ID     |

## Query Parameters

| Parameter | Type    | Required | Description                                                 |
| --------- | ------- | -------- | ----------------------------------------------------------- |
| `hard`    | boolean | No       | `true` permanently deletes the tool instead of disabling it |

## Responses

### `200` — Disabled (default)

```json theme={null}
{
  "success": true,
  "tool_id": "9a1b2c3d-0000-4000-8000-000000000001",
  "status": "disabled"
}
```

### `200` — Deleted (`?hard=true`)

```json theme={null}
{
  "success": true,
  "tool_id": "9a1b2c3d-0000-4000-8000-000000000001",
  "status": "deleted"
}
```

### `401` — Authentication error

See [Authentication](/docs/en/api/authentication).

### `404` — Not found

```json theme={null}
{
  "error": "Not found",
  "message": "Workflow not found"
}
```

### `500` — Internal server error