fn_registry/python/functions/metabase/metabase_create_document_comment.md at 4ac93a0933cd4e48e0bb52e260db93bf87c6df6b

Files

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

2.1 KiB

Raw Blame History

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_comment

function

infra

1.0.0

impure

def metabase_create_document_comment(client: MetabaseClient, document_id: int, content: dict, *, child_target_id: str | None = None, parent_comment_id: int | None = None) -> dict

Crea un comentario en un document. Soporta anclaje a bloque concreto (via UUID de _id) y respuestas en thread (via parent_comment_id). Endpoint: POST /api/comment.

metabase

document

comments

create

api

python

false

error_go_core

httpx

name	desc
client	instancia autenticada de MetabaseClient

name	desc
document_id	ID del document donde crear el comentario

name	desc
content	arbol ProseMirror del comentario: {type: doc, content: [...]}

name	desc
child_target_id	UUID de bloque al que se ancla el comentario (matchea attrs._id de un parrafo). None = comentario a nivel doc

name	desc
parent_comment_id	ID del comentario al que se responde. None = comentario top-level

dict: comentario creado con id, created_at, creator, reactions=[], is_resolved=False

false

python/functions/metabase/documents.py

Ejemplo

# Comentario top-level
metabase_create_document_comment(client, 29, {
    "type": "doc",
    "content": [{"type": "paragraph", "content": [
        {"type": "text", "text": "Deberiamos anadir un paso para configurar Slack"}
    ]}]
})

# Respuesta en thread
metabase_create_document_comment(client, 29, content=reply_tree,
                                  parent_comment_id=1)

# Anclado a un bloque concreto del documento
metabase_create_document_comment(client, 29, content=tree,
                                  child_target_id="48f9a7a4-79a0-a282-03a1-ffe2f76b9106")

Notas

target_type se fija internamente a "document" (unico valor aceptado por la API en v0.59).

El content sigue el mismo schema ProseMirror que los documents (ver whitelist en metabase_validate_document_payload).

2.1 KiB Raw Blame History

Ejemplo

Notas

2.1 KiB

Raw Blame History