---
name: metabase_create_dashboard_raw
kind: function
lang: py
domain: infra
version: "1.0.0"
purity: impure
signature: "def metabase_create_dashboard_raw(client: MetabaseClient, payload: dict) -> dict"
description: "Crea un dashboard en Metabase enviando el payload completo sin modificaciones. Maneja automaticamente la limitacion de la API que no acepta dashcards en el POST inicial: si el payload contiene dashcards, hace POST para crear el dashboard y luego PUT para añadir las cards. Endpoint: POST /api/dashboard (+ PUT condicional)."
tags: [metabase, dashboard, create, api, python, raw, as-code, dashcards]
uses_functions: [metabase_auth_py_infra]
uses_types: []
returns: []
returns_optional: false
error_type: "error_go_core"
imports: [httpx]
params:
  - name: client
    desc: "instancia autenticada de MetabaseClient con sesion activa"
  - name: payload
    desc: "dict con el payload completo del dashboard tal como lo espera la API de Metabase; campos soportados: name (requerido), description, collection_id, parameters, tabs, enable_embedding, embedding_params; dashcards (list[dict]): si presente, se extrae del body POST y se añade en un PUT posterior con id negativo para cards nuevas"
output: "dict: objeto dashboard creado; si habia dashcards en el payload, retorna la respuesta del PUT final con el campo dashcards poblado; si no habia dashcards, retorna la respuesta del POST inicial"
tested: false
tests: []
test_file_path: ""
file_path: "python/functions/metabase/dashboards.py"
---

## Ejemplo

```python
# Sin dashcards (solo POST)
dash = metabase_create_dashboard_raw(client, {
    "name": "Sales Overview",
    "description": "KPIs de ventas mensuales",
    "collection_id": 5,
    "parameters": [],
})
print(dash["id"])

# Con dashcards (POST + PUT automatico)
dash = metabase_create_dashboard_raw(client, {
    "name": "Sales Overview",
    "description": "KPIs de ventas mensuales",
    "collection_id": 5,
    "parameters": [],
    "dashcards": [
        {
            "id": -1,
            "card_id": 42,
            "size_x": 6,
            "size_y": 4,
            "col": 0,
            "row": 0,
            "visualization_settings": {},
            "parameter_mappings": [],
        },
    ],
})
print(dash["id"])
print(len(dash["dashcards"]))  # 1
```

## Notas

No se escriben tests automaticos porque requiere una instancia real de Metabase.
Los intentos de mockear `client.request` quedan fuera del alcance del registry
por ahora — la validacion se hace en integracion contra un entorno Metabase real.

La API de Metabase (al menos hasta v0.49) ignora el campo `dashcards` en el
POST inicial de creacion de dashboard. Esta funcion absorbe esa limitacion
internamente: extrae las dashcards del payload antes del POST y las envia en
un PUT separado usando el id que Metabase asigno al nuevo dashboard.

Si Metabase devuelve 4xx/5xx en cualquier paso, httpx lanza `HTTPStatusError`
sin capturar. Si el POST tiene exito pero el PUT falla, el dashboard queda
creado pero vacio — el caller debe manejar este caso si necesita atomicidad.
