---
name: metabase_copy_dashcard_mappings
kind: function
lang: py
domain: infra
version: "1.0.0"
purity: impure
signature: "def metabase_copy_dashcard_mappings(client: MetabaseClient, *, dashboard_id: int, source_card_id: int, dest_card_id: int) -> list[dict]"
description: "Copia los parameter_mappings del primer dashcard con source_card_id al card destino (dest_card_id), devolviendo una lista nueva de mappings sin mutar el original. Util para replicar filtros de dashboard a cards nuevas sin copiar manualmente cada mapping."
tags: [metabase, dashboard, parameter-mappings, dashcard, copy, api, python]
uses_functions:
  - metabase_get_dashboard_py_infra
uses_types: []
returns: []
returns_optional: false
error_type: "error_go_core"
imports: []
params:
  - name: client
    desc: "MetabaseClient autenticado con sesion activa"
  - name: dashboard_id
    desc: "ID del dashboard que contiene los dashcards fuente y destino"
  - name: source_card_id
    desc: "card_id del dashcard del que se copian los parameter_mappings"
  - name: dest_card_id
    desc: "card_id que se asigna como card_id en cada mapping copiado"
output: "list[dict]: parameter_mappings adaptados al card destino, cada uno con {parameter_id, card_id: dest_card_id, target}. Lista vacia si el dashcard fuente no tiene mappings."
tested: false
tests: []
test_file_path: ""
file_path: "python/functions/metabase/metabase_copy_dashcard_mappings.py"
---

## Ejemplo

```python
from metabase import MetabaseClient, metabase_copy_dashcard_mappings

client = MetabaseClient("https://metabase.example.com", "token...")

# Copiar los 18 filtros de la card 42 a la card nueva 99
mappings = metabase_copy_dashcard_mappings(
    client,
    dashboard_id=10,
    source_card_id=42,
    dest_card_id=99,
)

# Usar los mappings al añadir el nuevo dashcard
new_dashcard = {
    "id": -1,
    "card_id": 99,
    "col": 0, "row": 20, "size_x": 6, "size_y": 4,
    "parameter_mappings": mappings,
    "visualization_settings": {},
}
```

## Notas

- Localiza el **primer** dashcard con `card_id == source_card_id`. Si la misma card
  aparece varias veces en el dashboard (e.g. en distintas tabs), solo se usan los
  mappings del primero que encuentre.
- Lanza `ValueError` si `source_card_id` no aparece en el dashboard — falla rápido
  en vez de devolver lista vacía silenciosamente.
- No muta ni el dashboard ni los mappings originales: cada dict del resultado es
  construido desde cero con las tres claves que acepta la API
  (`parameter_id`, `card_id`, `target`).
- Requiere 1 request HTTP (GET dashboard). Para aplicar los mappings al dashboard
  usar `metabase_update_dashboard_safe` con `dashcards_add`.