Actualizar Client Tool

PATCH /client-tools/:id Edita una tool del catálogo. Cualquier cambio en description, url, method, parameters, headers, query_parameters, o timeout_ms se propaga a todos los agentes que hayan asignado (heredado) esta tool, junto con is_active. Los campos de voz/runtime (speak_during_execution, speak_after_execution, response_variables, execution_message_type, execution_message_description) y sort_order/llm_response_fields se copian una sola vez al asignar, pero no se propagan en ediciones posteriores — quedan con alcance por workflow.

Parámetros de Ruta

Parámetro	Tipo	Requerido	Descripción
`id`	string (uuid)	Sí	ID de la client tool

Cuerpo de la Solicitud

Cualquier subconjunto de los campos abajo. Se requiere al menos uno.

Campo	Tipo	Requerido	Descripción
`description`	string	No	No vacío, máximo 1024 caracteres. No se puede limpiar a null/vacío
`url`	string	No	No vacío. No se puede limpiar a null/vacío
`method`	string	No	`GET`, `POST`, `PUT`, `PATCH`, o `DELETE`
`parameters`	object	No	Objeto estilo JSON-schema que describe los argumentos de llamada de la tool
`headers`	object	No	Headers estáticos enviados en cada llamada
`query_parameters`	object	No	Query params estáticos enviados en cada llamada
`timeout_ms`	integer	No	Limitado entre 1,000 y 120,000
`speak_during_execution`	boolean	No	Con alcance por workflow después de asignar — no se propaga
`speak_after_execution`	boolean	No	Con alcance por workflow después de asignar — no se propaga
`response_variables`	object	No	Con alcance por workflow después de asignar — no se propaga
`execution_message_type`	string	No	Con alcance por workflow después de asignar — no se propaga
`execution_message_description`	string	No	Con alcance por workflow después de asignar — no se propaga
`llm_response_fields`	string[]	No	Solo de catálogo, nunca se copia ni se propaga
`is_active`	boolean	No	Se propaga a las réplicas heredadas
`sort_order`	integer	No	Solo de catálogo, nunca se copia ni se propaga

name no se puede cambiar aquí — elimina y vuelve a crear la tool para renombrarla.

Respuestas

`200` — Actualizada

{
  "success": true,
  "tool": {
    "id": "7c1b2c3d-0000-4000-8000-000000000002",
    "name": "check_subscription",
    "description": "Checks whether the lead has an active subscription and its plan tier",
    "url": "https://api.acme.com/subscriptions/status",
    "method": "GET",
    "timeout_ms": 10000
  },
  "propagated_workflow_tools": 3
}

propagated_workflow_tools es la cantidad de filas heredadas en workflow_tools actualizadas por esta edición (0 si la actualización solo tocó campos no propagados). Ver Listar Client Tools para la referencia completa de campos de ClientTool.

`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 "description must be a non-empty string", "description must be at most 1024 characters", "url must be a non-empty string", "method must be one of: GET, POST, PUT, PATCH, DELETE", "timeout_ms must be a number", o "Nothing to update".

`401` — Error de autenticación

Ver Autenticación.

`404` — No encontrado

{
  "error": "Not found",
  "message": "Tool not found"
}

`500` — Error interno del servidor

Última modificación el 15 de julio de 2026

Crear Client Tool

Eliminar Client Tool

​Parámetros de Ruta

​Cuerpo de la Solicitud

​Respuestas

​200 — Actualizada

​400 — Error de validación

​401 — Error de autenticación

​404 — No encontrado

​500 — Error interno del servidor