Files
fn_registry/python/functions/metabase/metabase_create_document.md
T
egutierrez 9a28d08e38 feat(metabase): expansion de funciones Python — documents, collections, permissions, validation
Añade un conjunto amplio de funciones al paquete python/functions/metabase:
- Nuevos modulos: collections.py, documents.py, maintenance.py, permissions.py, validation.py (+ test).
- Ampliacion de cards.py, dashboards.py, client.py e __init__.py para exponer las nuevas operaciones.
- Funciones de documentos (create/get/update/delete/archive/copy/move + comentarios), grupos y memberships, permission/collection graphs, copy/move de cards y dashboards, validacion de MBQL/SQL y payloads, actualizacion segura de dashboards y fix_null_ratio.
- .md por funcion con frontmatter para que fn index los registre.
- Actualiza pyproject.toml y uv.lock con las dependencias resultantes.

Impacto: ampliamente mas cobertura de la API de Metabase desde el registry, reutilizable por apps y analisis. No toca Go ni frontend.
2026-04-13 23:31:42 +02:00

1.7 KiB

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_document function py infra 1.0.0 impure def metabase_create_document(client: MetabaseClient, name: str, document: dict, collection_id: int = 0) -> dict Crea un document nuevo con contenido ProseMirror. Endpoint: POST /api/document. Soporta cardEmbed, smartLink, flexContainer, callout, taskList y demas nodos custom de Metabase.
metabase
document
create
api
prosemirror
python
false error_go_core
httpx
name desc
client instancia autenticada de MetabaseClient
name desc
name titulo del document (1-254 caracteres, no blank)
name desc
document arbol ProseMirror JSON: {type: 'doc', content: [...]}, o '' para arrancar vacio
name desc
collection_id ID de coleccion destino (0 = root)
dict: document recien creado con id, entity_id y metadata false
python/functions/metabase/documents.py

Ejemplo

doc = metabase_create_document(client, "Notas", {
    "type": "doc",
    "content": [
        {"type": "paragraph", "content": [{"type": "text", "text": "Hola"}]}
    ]
})
print(doc["id"])

Notas

Nodos custom de Metabase observados (v0.59): cardEmbed (attrs.id=card_id), smartLink (attrs.entityId), flexContainer (attrs.columnWidths), resizeNode, mention. Marks estandar + underline, highlight, subscript, textStyle.

Cuando embebes un card via cardEmbed, Metabase crea una copia interna del card con document_id apuntando al document — no referencia el card original.