fn_registry/python/functions/metabase/metabase_create_card_alert.md

name, kind, lang, domain, version, purity, signature, description, tags, uses_functions, uses_types, returns, returns_optional, error_type, imports, params, output, tested, tests, test_file_path, file_path

name	kind	lang	domain	version	purity	signature	description	tags	uses_functions	uses_types	returns	returns_optional	error_type	imports	params	output	tested	tests	test_file_path	file_path
metabase_create_card_alert	function	py	infra	1.0.0	impure	def metabase_create_card_alert(client: MetabaseClient, card_id: int, cron_schedule: str, recipients: list[dict], send_condition: str = 'has_result', send_once: bool = False) -> dict	Crea una alerta sobre los resultados de una card en Metabase. Envia email segun cron cuando la card cumple la condicion (has_result, goal_above, goal_below). Endpoint: POST /api/notification.	metabase notification alert card create api python pendiente-usar				false	error_go_core		name desc client instancia autenticada de MetabaseClient name desc card_id ID de la card que dispara la alerta name desc cron_schedule expresion cron de 5 campos (ej: '0 9 * * 1' = lunes 9am, '0 8 * * 1-5' = lun-vie 8am) name desc recipients lista de destinatarios: usuario Metabase {'type': 'notification-recipient/user', 'user_id': N} o email externo {'type': 'notification-recipient/raw-value', 'details': {'email': 'x@y.com'}} name desc send_condition condicion que dispara el envio: 'has_result' (tiene filas), 'goal_above' (supera goal), 'goal_below' (cae bajo goal) name desc send_once si True, se envia una sola vez y se desactiva automaticamente	dict: notificacion creada con id, active, payload_type, payload, subscriptions, handlers, created_at	false			python/functions/metabase/notifications.py

Ejemplo

# Alerta: enviar email los lunes 9am si la card tiene resultados
alert = metabase_create_card_alert(
    client,
    card_id=7711,
    cron_schedule="0 9 * * 1",
    recipients=[
        {"type": "notification-recipient/user", "user_id": 1},
        {"type": "notification-recipient/raw-value", "details": {"email": "team@aurgi.com"}},
    ],
    send_condition="has_result",
)
print(alert["id"], alert["active"])

Notas

Requiere Metabase 0.57+. Reemplaza el antiguo /api/pulse. El campo subscriptions acepta solo el tipo notification-subscription/cron. Para alertas de goal configurar previamente el goal en la visualizacion de la card. send_once=True es util para alertas puntuales que no deben repetirse.