# 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](/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.           |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.anunzi.net/api-calls/actualizar-llamada.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.