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

# Actualizar acción durante la llamada

> Modifica una acción durante la llamada existente en Famulor a través de la API. Actualiza el nombre, el endpoint, los parámetros o la descripción para que los agentes de voz de IA invoquen la acción correcta.

<Warning>
  **API de Famulor 1.0 (legado).** Esta página se aplica únicamente a Famulor 1.0 (`app.famulor.de`) y se conserva por compatibilidad. Para la plataforma actual, usa la [referencia de la API de Famulor 2.0](/es/api-reference/introduction).
</Warning>

Este endpoint te permite actualizar una acción durante la llamada existente. Todos los campos son opcionales: solo proporciona los campos que quieras actualizar.

### Parámetros de ruta

<ParamField path="id" type="integer" required>
  El identificador único de la acción durante la llamada que se va a actualizar
</ParamField>

### Parámetros del cuerpo

En las acciones durante la llamada vinculadas a un flujo de la plataforma de automatización, los campos `endpoint`, `method` y `body_format` se ignoran para proteger la conexión del flujo.

<ParamField body="name" type="string" optional>
  Nombre de la acción durante la llamada: letras, números y guiones bajos, que empiece por una letra o un guion bajo (máx. 64 caracteres)
</ParamField>

<ParamField body="description" type="string" optional>
  Explicación detallada de cuándo y cómo debe usar la IA esta acción durante la llamada (máx. 255 caracteres)
</ParamField>

<ParamField body="endpoint" type="string" optional>
  URL válida del endpoint de la API a llamar (máx. 2048 caracteres)
</ParamField>

<ParamField body="method" type="string" optional>
  Método HTTP: `GET`, `POST`, `PUT`, `PATCH` o `DELETE`
</ParamField>

<ParamField body="body_format" type="string" optional>
  Codificación del cuerpo de la solicitud para los métodos de escritura: `json` (predeterminado) o `form`
</ParamField>

<ParamField body="timeout" type="integer" optional>
  Tiempo de espera de la solicitud en segundos (1-30)
</ParamField>

<ParamField body="headers" type="array" optional>
  Encabezados HTTP que se enviarán con la solicitud (reemplaza los encabezados existentes)

  <Expandable title="Propiedades de headers">
    <ParamField body="name" type="string" required>
      Nombre del encabezado
    </ParamField>

    <ParamField body="value" type="string" required>
      Valor del encabezado (admite sustitución de `{{variable}}`)
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="static_fields" type="array" optional>
  Pares clave/valor fijos que siempre se envían con la solicitud (reemplaza los campos estáticos existentes)

  <Expandable title="Propiedades de static_fields">
    <ParamField body="key" type="string" required>
      Clave del campo (máx. 64 caracteres)
    </ParamField>

    <ParamField body="value" type="string" optional>
      Valor del campo (máx. 2048 caracteres; admite sustitución de `{{variable}}`)
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="schema" type="array" optional>
  Esquema de parámetros (reemplaza el esquema existente)

  <Expandable title="Propiedades de schema">
    <ParamField body="name" type="string" required>
      Nombre del parámetro (1-64 caracteres, empieza por una letra o un guion bajo)
    </ParamField>

    <ParamField body="type" type="string" required>
      Tipo de parámetro: `string`, `number`, `float` o `boolean`
    </ParamField>

    <ParamField body="description" type="string" required>
      Descripción del parámetro (3-255 caracteres)
    </ParamField>

    <ParamField body="required" type="boolean" optional>
      Indica si la IA debe recopilar este parámetro obligatoriamente (predeterminado `false`)
    </ParamField>
  </Expandable>
</ParamField>

### Campos de respuesta

<ResponseField name="message" type="string">
  Mensaje de éxito
</ResponseField>

<ResponseField name="data" type="object">
  El objeto de la acción durante la llamada actualizado con todos los valores actuales
</ResponseField>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "message": "Tool updated successfully",
    "data": {
      "id": 1,
      "name": "send_notification",
      "description": "Use this tool to send a notification to the customer. Call this when customer requests updates.",
      "type": "http",
      "endpoint": "https://api.yourcompany.com/notifications/send",
      "method": "POST",
      "body_format": "json",
      "timeout": 15,
      "headers": [
        {
          "name": "Content-Type",
          "value": "application/json"
        }
      ],
      "static_fields": [
        {
          "key": "caller",
          "value": "{{customer_phone}}"
        }
      ],
      "schema": [
        {
          "name": "message",
          "type": "string",
          "description": "The notification message to send",
          "required": true
        },
        {
          "name": "send_sms",
          "type": "boolean",
          "description": "Whether to also send SMS notification",
          "required": false
        }
      ],
      "created_at": "2025-10-10T12:00:00.000000Z",
      "updated_at": "2025-10-10T14:30:00.000000Z"
    }
  }
  ```

  ```json 404 Not Found theme={null}
  {
    "message": "Tool not found"
  }
  ```

  ```json 422 Validation Error theme={null}
  {
    "message": "Validation failed",
    "errors": {
      "name": ["Tool name must contain only letters, numbers and underscores, and start with a letter or underscore."]
    }
  }
  ```
</ResponseExample>

### Gestionar las asignaciones de acciones durante la llamada

Para vincular o desvincular esta acción durante la llamada de los asistentes, usa la API de asistentes:

* **[Crear asistente](/es/api-v1/assistants/create)** — Usa el parámetro `tool_ids` para vincular acciones durante la llamada al crear un asistente
* **[Actualizar asistente](/es/api-v1/assistants/update)** — Usa el parámetro `tool_ids` para gestionar qué acciones durante la llamada están asignadas a un asistente

<Tip>
  ¿Necesitas todo un conjunto de herramientas en lugar de crear acciones HTTP una por una? Conecta un **servidor MCP** externo: las herramientas se descubren automáticamente. Consulta [Servidores MCP](/es/api/tools-and-webhooks).
</Tip>