Actualizar Workflow Tool

PATCH /workflows/:id/tools/:toolId 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, 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

{
  "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

{
  "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.

`404` — No encontrado

{
  "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

Última modificación el 10 de julio de 2026

Crear Workflow Tool

Eliminar Workflow Tool

​Parámetros de Ruta

​Cuerpo de la Solicitud

​Respuestas

​200 — Tool actualizada

​400 — Error de validación

​401 — Error de autenticación

​404 — No encontrado

​500 — Error interno del servidor