# Borrar una audiencia

`delete_audience`

Borra una audiencia del perfil de marca por su id de list_audiences y la quita de los productos que la tenían asociada. Los productos no se borran. Sin confirm devuelve la vista previa con los productos afectados; muéstrale esa vista previa al usuario antes de borrar.

**Permiso:** Edición. Requiere un token de «Lectura y edición».

> **Cambia datos:** Modifica información de tu empresa en Bison. Tu agente debería pedirte confirmación antes de usarla.

## Parámetros

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `audience_id` | texto | Sí | id de la audiencia a borrar. |
| `confirm` | booleano | No | false u omitido: solo devuelve la vista previa, con el antes y el después, sin guardar. true: guarda. |

## Ejemplo de llamada

No tienes que escribir esto: tu agente decide cuándo usar la herramienta según lo que le pidas. Es la llamada MCP equivalente, con valores de relleno:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "delete_audience",
    "arguments": {
      "audience_id": "<audience_id>"
    }
  }
}
```

## Ejemplo de vista previa

Sin `confirm`, con `{"audience_id":"aud_conductores"}`, no guarda nada y devuelve esto, para la marca ficticia «Altavista Seguros». Para guardar, repite la llamada con `confirm: true`.

```json
{
  "saved": false,
  "changed": true,
  "audience": {
    "id": "aud_conductores",
    "name": "Conductores urbanos"
  },
  "affected": {
    "products": [
      {
        "id": "prd_auto",
        "name": "Seguro de auto por kilómetro"
      }
    ]
  },
  "notes": "Vista previa: no se guardó nada. Muéstrale el cambio al usuario y repite la llamada con confirm: true para hacerlo."
}
```