---
name: metabase_update_dashboard
kind: function
lang: go
domain: infra
version: "1.0.0"
purity: impure
signature: "func MetabaseUpdateDashboard(client MetabaseClient, dashboardID int, fields map[string]any) (map[string]any, error)"
description: "Actualiza un dashboard en Metabase incluyendo metadata, cards y tabs. El campo dashcards representa el estado completo deseado: cards nuevas con ID negativo, existentes con ID positivo, omitidas se eliminan. Endpoint: PUT /api/dashboard/:id."
tags: [metabase, dashboard, update, cards, api]
uses_functions: []
uses_types: [MetabaseClient_go_infra]
returns: []
returns_optional: false
error_type: "error_go_core"
imports: [fmt]
params:
  - name: client
    desc: "cliente MetabaseClient autenticado"
  - name: dashboardID
    desc: "ID del dashboard a actualizar"
  - name: fields
    desc: "mapa con campos a modificar (name, description, dashcards, tabs, archived, etc.)"
output: "mapa con los detalles del dashboard actualizado"
tested: false
tests: []
test_file_path: ""
file_path: "functions/infra/metabase_update_dashboard.go"
---

## Ejemplo

```go
// Cambiar nombre
MetabaseUpdateDashboard(client, 1, map[string]any{
    "name": "Updated Dashboard",
})

// Agregar una card al dashboard
// Primero obtener las dashcards existentes
dash, _ := MetabaseGetDashboard(client, 1)
existingCards := dash["dashcards"].([]any)

// Construir nuevo array con las existentes + la nueva
dashcards := make([]map[string]any, 0)
for _, dc := range existingCards {
    dashcards = append(dashcards, dc.(map[string]any))
}
// Agregar nueva card (ID negativo = nueva)
dashcards = append(dashcards, map[string]any{
    "id": -1, "card_id": 55, "size_x": 6, "size_y": 4, "col": 0, "row": 0,
})

MetabaseUpdateDashboard(client, 1, map[string]any{
    "dashcards": dashcards,
})

// Archivar dashboard (soft-delete)
MetabaseUpdateDashboard(client, 1, map[string]any{"archived": true})
```

## Notas

### Gestion de dashcards (IMPORTANTE)

El array `dashcards` representa el **estado completo deseado** del dashboard:

| Accion | Como hacerlo |
|--------|-------------|
| Agregar card | Incluir con **ID negativo** (-1, -2, etc.) |
| Actualizar card | Incluir con su **ID positivo** existente |
| Eliminar card | **Omitir** del array |
| No cambiar cards | No incluir el campo dashcards |

**Flujo tipico para agregar una card:**
1. `MetabaseGetDashboard` para obtener dashcards existentes
2. Copiar las existentes al nuevo array
3. Agregar la nueva con ID negativo
4. Enviar el array completo

### Estructura de una dashcard

```go
map[string]any{
    "id":                      -1,              // negativo = nueva, positivo = existente
    "card_id":                 42,              // ID de la card/pregunta
    "size_x":                  6,               // ancho (1-18)
    "size_y":                  4,               // alto
    "col":                     0,               // columna (0-based)
    "row":                     0,               // fila (0-based)
    "dashboard_tab_id":        nil,             // tab (nil = sin tabs)
    "parameter_mappings":      []map[string]any{}, // mapeo de filtros
    "visualization_settings":  map[string]any{},   // settings custom
}
```

### Gestion de tabs

```go
map[string]any{
    "tabs": []map[string]any{
        {"id": 1, "name": "Overview"},           // tab existente
        {"id": -1, "name": "Details"},           // tab nuevo (ID negativo)
    },
}
```

### Campos actualizables

| Campo | Tipo | Descripcion |
|-------|------|-------------|
| name | string | Nombre del dashboard |
| description | string | Descripcion |
| archived | bool | Archivar/desarchivar |
| dashcards | []map | Estado completo de cards |
| tabs | []map | Tabs del dashboard |
| parameters | []map | Filtros del dashboard |
| collection_id | int | Mover a otra coleccion |
