> ## 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.

# Eliminar Workflow Tool

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

Elimina una tool personalizada. Por defecto la **deshabilita** (`is_active: false`) para que las llamadas pasadas queden en el historial; pasa `?hard=true` para eliminar la fila permanentemente.

## Parámetros de Ruta

| Parámetro | Tipo          | Requerido | Descripción   |
| --------- | ------------- | --------- | ------------- |
| `id`      | string (uuid) | **Sí**    | ID del agente |
| `toolId`  | string (uuid) | **Sí**    | ID de la tool |

## Parámetros de Consulta

| Parámetro | Tipo    | Requerido | Descripción                                                       |
| --------- | ------- | --------- | ----------------------------------------------------------------- |
| `hard`    | boolean | No        | `true` elimina la tool permanentemente en lugar de deshabilitarla |

## Respuestas

### `200` — Deshabilitada (por defecto)

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

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

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

### `401` — Error de autenticación

Ver [Autenticación](/docs/es/api/authentication).

### `404` — No encontrado

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

### `500` — Error interno del servidor