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

# Actualizar Workflow Tool

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

Edita la configuración de una tool personalizada. `name` es inmutable — el prompt del agente la referencia, así que elimina y recrea la tool en lugar de renombrarla.

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

## Cuerpo de la Solicitud

Provee al menos un campo. Misma forma que [Crear Workflow Tool](/docs/es/api/workflow-tools/create-workflow-tool), sin `name`.

| Campo                   | Tipo              | Requerido | Descripción                               |
| ----------------------- | ----------------- | --------- | ----------------------------------------- |
| `description`           | string            | No        |                                           |
| `url`                   | string            | No        |                                           |
| `method`                | string            | No        | `GET`, `POST`, `PUT`, `PATCH`, o `DELETE` |
| `parameters`            | object            | No        |                                           |
| `headers`               | object            | No        |                                           |
| `query_parameters`      | object            | No        |                                           |
| `timeout_ms`            | integer           | No        |                                           |
| `available_in_statuses` | string\[] \| null | No        |                                           |
| `auto_run_on_entry`     | boolean           | No        |                                           |
| `call_once`             | boolean           | No        |                                           |
| `is_active`             | boolean           | No        |                                           |

## Respuestas

### `200` — Tool actualizada

```json theme={null}
{
  "success": true,
  "tool": {
    "id": "9a1b2c3d-0000-4000-8000-000000000001",
    "name": "check_availability",
    "description": "Checks open slots, including weekends",
    "method": "GET",
    "url": "https://api.acme.com/availability",
    "is_active": true,
    "available_in_statuses": null,
    "auto_run_on_entry": false,
    "call_once": false,
    "sort_order": 0
  }
}
```

### `400` — Error de validación

```json theme={null}
{
  "error": "Invalid input",
  "message": "name is immutable (the agent references it); delete + recreate to rename"
}
```

También se devuelve como `"invalid method"` o `"Nothing to update"`.

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

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

### `404` — No encontrado

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

También se devuelve si el agente mismo no existe (`"Workflow not found"`).

### `500` — Error interno del servidor