> For the complete documentation index, see [llms.txt](https://anunzi-ai.gitbook.io/anunzi-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://anunzi-ai.gitbook.io/anunzi-docs/api-calls/actualizar-llamada.md).

# 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](/anunzi-docs/api-calls/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.           |