# Actualizar llamada

**PATCH** `/v2/update-call/{call_id}`

Permite modificar los metadatos, configuración de almacenamiento y variables dinámicas de una llamada existente, ya sea que esté en curso o finalizada.

---

## Parámetros de ruta

| Campo | Tipo | Requerido | Descripción |
|-------|------|-----------|-------------|
| `call_id` | string | Sí | ID de la llamada a actualizar. Ejemplo: `call_a4441234567890777c4a4a123e6` |

---

## Parámetros del cuerpo (todos opcionales)

| Campo | Tipo | Descripción |
|-------|------|-------------|
| `metadata` | object | Objeto libre para almacenar información adicional sobre la llamada. Tamaño máximo: 50 KB. Ejemplo: `{"crm_id": "LEAD-9821", "notas": "Requiere seguimiento"}` |
| `data_storage_setting` | string | Política de almacenamiento de datos para esta llamada. Valores: `everything` \| `everything_except_pii` \| `basic_attributes_only`. **Nota:** No se puede reducir a una política menos restrictiva que la actual. |
| `override_dynamic_variables` | object | Sobreescribe las variables dinámicas del agente durante la llamada activa. Envía `null` para eliminar las sobreescrituras existentes. Ejemplo: `{"descuento_adicional": "15%"}` |
| `custom_attributes` | object | Atributos personalizados para clasificación o análisis. Los valores pueden ser string, número o booleano. Ejemplo: `{"segmento": "enterprise", "prioridad": 1}` |

---

## Respuesta — 200 OK

Devuelve el objeto completo de la llamada actualizada, con el mismo esquema que [Obtener llamada](obtener-llamada.md).

---

## Ejemplos de solicitud

### Agregar metadatos a una llamada finalizada

```bash
curl --request PATCH \
     --url https://calls.anunzi.net/v2/update-call/call_a4441234567890777c4a4a123e6 \
     --header 'Authorization: Bearer TU_API_KEY' \
     --header 'Content-Type: application/json' \
     --data '{
  "metadata": {
    "crm_id": "LEAD-9821",
    "resultado": "interesado",
    "agente_humano": "Carlos Méndez"
  }
}'
```

### Modificar variable dinámica durante una llamada en curso

```bash
curl --request PATCH \
     --url https://calls.anunzi.net/v2/update-call/call_a4441234567890777c4a4a123e6 \
     --header 'Authorization: Bearer TU_API_KEY' \
     --header 'Content-Type: application/json' \
     --data '{
  "override_dynamic_variables": {
    "descuento_adicional": "20%",
    "plan_ofrecido": "Pro Anual"
  }
}'
```

### Cambiar política de almacenamiento

```bash
curl --request PATCH \
     --url https://calls.anunzi.net/v2/update-call/call_a4441234567890777c4a4a123e6 \
     --header 'Authorization: Bearer TU_API_KEY' \
     --header 'Content-Type: application/json' \
     --data '{
  "data_storage_setting": "everything_except_pii"
}'
```

---

## Políticas de almacenamiento

| Valor | Descripción |
|-------|-------------|
| `everything` | Se almacena todo: grabación, transcripción, análisis, PII. |
| `everything_except_pii` | Se almacena todo excepto información personal identificable. |
| `basic_attributes_only` | Solo se almacenan atributos básicos (duración, estado, timestamps). No se guarda grabación ni transcripción. |

---

## Códigos de estado

| Código | Descripción |
|--------|-------------|
| `200` | Llamada actualizada correctamente. |
| `400` | Formato de solicitud inválido. |
| `401` | API Key ausente o inválida. |
| `422` | La llamada no existe bajo tu API Key. |
| `500` | Error interno del servidor. |