Miro

​

Überblick

Visueller Workspace für Innovation, der verteilte Teams zur Zusammenarbeit befähigt. Über die Integration von Langdock kannst du auf Miro zugreifen und es direkt aus deinen Unterhaltungen verwalten.

​

Verfügbare Aktionen

​

Boards abrufen

miro.getBoards

Ruft eine Liste von Boards ab, auf die der User zugreifen kann Benötigt Bestätigung: Nein Parameter:

• teamId (TEXT, Optional): Optionale Team-ID zum Filtern von Boards

Output: Gibt ein Array von Boards mit ihren IDs, Namen, Beschreibungen und anderen Details zurück

---

​

Boards durchsuchen

miro.searchBoards

Suche nach Boards anhand von Name oder Beschreibung Benötigt Bestätigung: Nein Parameter:

• query (TEXT, Erforderlich): Suchbegriff zum Finden von Boards
  • teamId (TEXT, Optional): Optionale Team-ID zum Filtern der Suchergebnisse
  • limit (NUMBER, Optional): Maximale Anzahl zurückzugebender Boards (Standard: 10)

Output: Gibt ein Array von Boards zurück, die den Suchkriterien entsprechen

---

​

Aktuelle Boards abrufen

miro.getRecentBoards

Hole kürzlich geänderte Boards, sortiert nach Änderungsdatum Benötigt Bestätigung: Nein Parameter:

• limit (NUMBER, Optional): Maximale Anzahl zurückzugebender Boards (Standard: 10)
  • teamId (TEXT, Optional): Optionale Team-ID zum Filtern von Boards

Output: Gibt ein Array kürzlich geänderter Boards zurück

---

​

Board-Details abrufen

miro.getBoardDetails

Ruft detaillierte Informationen über ein bestimmtes Board ab Benötigt Bestätigung: Nein Parameter:

• boardId (TEXT, Erforderlich): Die eindeutige Kennung des Boards

Output: Gibt Board-Details zurück, einschließlich ID, Name, Beschreibung und anderen Eigenschaften

---

​

Board-Elemente abrufen

miro.getBoardItems

Ruft alle Elemente eines Boards mit optionaler Filterung nach Typ ab Benötigt Bestätigung: Nein Parameter:

• boardId (TEXT, Erforderlich): Die eindeutige Kennung des Boards
  • itemType (TEXT, Optional): Nach Element-Typ filtern (z.B. sticky_note, text, shape, frame, card)

Output: Gibt ein Array von Board-Elementen mit ihren Details zurück

---

​

Frames abrufen

miro.getFrames

Ruft alle Frames eines Boards ab Benötigt Bestätigung: Nein Parameter:

• boardId (TEXT, Erforderlich): Die eindeutige Kennung des Boards

Output: Gibt ein Array von Frames mit ihren Details zurück

---

​

Frame-Elemente abrufen

miro.getFrameItems

Ruft alle Elemente innerhalb eines bestimmten Frames ab Benötigt Bestätigung: Nein Parameter:

• boardId (TEXT, Erforderlich): Die eindeutige Kennung des Boards
  • frameId (TEXT, Erforderlich): Die eindeutige Kennung des Frames

Output: Gibt ein Array von Elementen innerhalb des angegebenen Frames zurück

---

​

Board-Tags abrufen

miro.getBoardTags

Ruft alle auf einem Board verwendeten Tags für Organisation und Kategorisierung ab Benötigt Bestätigung: Nein Parameter:

• boardId (TEXT, Erforderlich): Die eindeutige Kennung des Boards

Output: Gibt ein Array von Tags mit ihren Details zurück

---

​

Bestimmtes Element abrufen

miro.getSpecificItem

Ruft ein bestimmtes Element auf einem Board anhand seiner ID ab Benötigt Bestätigung: Nein Parameter:

• boardId (TEXT, Erforderlich): Die ID des Boards, das das Element enthält
  • itemId (TEXT, Erforderlich): Die ID des bestimmten Elements, das abgerufen werden soll

Output: Gibt das bestimmte Element mit seinen Details zurück

---

​

Frame abrufen

miro.getFrame

Ruft ein bestimmtes Frame-Element anhand seiner ID ab Benötigt Bestätigung: Nein Parameter:

• boardId (TEXT, Erforderlich): Die ID des Boards, das den Frame enthält
  • frameId (TEXT, Erforderlich): Die ID des abzurufenden Frames

Output: Gibt den bestimmten Frame mit seinen Details zurück

---

​

Card-Element abrufen

miro.getCardItem

Ruft ein bestimmtes Card-Element anhand seiner ID ab Benötigt Bestätigung: Nein Parameter:

• boardId (TEXT, Erforderlich): Die ID des Boards, das die Card enthält
  • cardId (TEXT, Erforderlich): Die ID der abzurufenden Card

Output: Gibt die bestimmte Card mit ihren Details zurück

---

​

Dokument-Element abrufen

miro.getDocumentItem

Ruft ein bestimmtes Dokument-Element anhand seiner ID ab Benötigt Bestätigung: Nein Parameter:

• boardId (TEXT, Erforderlich): Die ID des Boards, das das Dokument enthält
  • documentId (TEXT, Erforderlich): Die ID des abzurufenden Dokuments

Output: Gibt das bestimmte Dokument mit seinen Details zurück

---

​

Embed-Element abrufen

miro.getEmbedItem

Ruft ein bestimmtes Embed-Element anhand seiner ID ab Benötigt Bestätigung: Nein Parameter:

• boardId (TEXT, Erforderlich): Die ID des Boards, das das Embed enthält
  • itemId (TEXT, Erforderlich): Die ID des abzurufenden Embeds

Output: Gibt das bestimmte Embed mit seinen Details zurück

---

​

Shape-Element abrufen

miro.getShapeItem

Ruft ein bestimmtes Shape-Element anhand seiner ID ab Benötigt Bestätigung: Nein Parameter:

• boardId (TEXT, Erforderlich): Die ID des Boards, das das Shape enthält
  • itemId (TEXT, Erforderlich): Die ID des abzurufenden Shapes

Output: Gibt das bestimmte Shape mit seinen Details zurück

---

​

Sticky Note-Element abrufen

miro.getStickyNoteItem

Ruft ein bestimmtes Sticky Note-Element anhand seiner ID ab Benötigt Bestätigung: Nein Parameter:

• boardId (TEXT, Erforderlich): Die ID des Boards, das die Sticky Note enthält
  • itemId (TEXT, Erforderlich): Die ID der abzurufenden Sticky Note

Output: Gibt die bestimmte Sticky Note mit ihren Details zurück

---

​

Text-Element abrufen

miro.getTextItem

Ruft ein bestimmtes Text-Element anhand seiner ID ab Benötigt Bestätigung: Nein Parameter:

• boardId (TEXT, Erforderlich): Die ID des Boards, das den Text enthält
  • itemId (TEXT, Erforderlich): Die ID des abzurufenden Text-Elements

Output: Gibt das bestimmte Text-Element mit seinen Details zurück

---

​

Seiteninhalt abrufen

miro.getPageContent

Ruft den Inhalt einer bestimmten Seite oder eines Blocks und alle seine Kinder aus Notion ab und konvertiert sie in Markdown Benötigt Bestätigung: Nein Parameter:

• blockId (TEXT, Erforderlich): Die eindeutige Kennung der Notion-Seite oder des Blocks, dessen Inhalt du abrufen möchtest, einschließlich aller verschachtelten Kinder-Blöcke und ihres formatierten Inhalts

Output: Gibt den Seiteninhalt im Markdown-Format zurück

---

​

Datenbank abfragen

miro.queryDatabase

Gibt Seiten aus einer Datenbank mit optionalen Filtern, Sortierungen und Paginierung zurück. Verwende diese Aktion, wann immer du mehrere Seiten aus einer Datenbank abrufen möchtest Benötigt Bestätigung: Nein Parameter:

• databaseId (TEXT, Erforderlich): ID oder URL der abzufragenden Datenbank
  • filter (TEXT, Optional): Notion-Filter-Objekt JSON. Unterstützt ‘and’/‘or’-Verbund-Filter und alle typ-spezifischen Bedingungen
  • sorts (OBJECT, Optional): Array von Notion-Sortier-Objekten. Beispiel: [property’:‘Last ordered’,‘direction’:‘ascending]
  • pageSize (NUMBER, Optional): Anzahl der Ergebnisse pro Seite (max 100). Standard 30
  • startCursor (TEXT, Optional): Cursor aus einer vorherigen Antwort für Paginierung
  • filterProperties (TEXT, Optional): Komma-getrennte Eigenschafts-IDs zum Einschließen in die Antwort
  • returnAll (BOOLEAN, Optional): Wenn true, paginiert bis alle Ergebnisse gesammelt sind
  • simplifyOutput (BOOLEAN, Optional): Vereinfachte Seiten mit id, url, title und flachen Eigenschaften zurückgeben

Output: Gibt ein Array von Datenbank-Seiten mit ihren Eigenschaften und Inhalten zurück

---

​

Datenbank erstellen

miro.createDatabase

Erstellt eine Datenbank als Unter-Seite in der angegebenen Eltern-Seite mit dem angegebenen Eigenschaften-Schema. Benötigt, dass die Eltern-Seite eine tatsächliche Seite oder ein Wiki ist Benötigt Bestätigung: Ja Parameter:

• parentId (TEXT, Erforderlich): ID oder URL der Eltern-SEITE (oder Wiki), unter der die Datenbank erstellt wird
  • title (TEXT, Optional): Optionaler Datenbank-Titel
  • properties (OBJECT, Erforderlich): Eigenschaften-Schema-Objekt. Beispiel: Name’: title’: }, ‘Status’: status’: }, ‘Price’: number’: format’: ‘dollar}}
  • icon (TEXT, Optional): Emoji oder vollständiges Icon-Objekt
  • cover (TEXT, Optional): Externe Cover-URL oder vollständiges externes Datei-Objekt
  • isInline (BOOLEAN, Optional): Die Datenbank inline auf der Seite erstellen

Output: Gibt die erstellte Datenbank mit ID, Titel und Eigenschaften-Schema zurück

---

​

Datenbank aktualisieren

miro.updateDatabase

Aktualisiert Datenbank-Metadaten (Titel, Beschreibung, Icon, Cover) und/oder modifiziert Datenbank-Eigenschaften (hinzufügen, entfernen, umbenennen oder Schema ändern) Benötigt Bestätigung: Ja Parameter:

• databaseId (TEXT, Erforderlich): ID oder URL der zu aktualisierenden Datenbank
  • title (TEXT, Optional): Optionaler neuer Datenbank-Titel
  • description (TEXT, Optional): Optionale neue Datenbank-Beschreibung
  • properties (OBJECT, Optional): JSON-Objekt, das Eigenschaftsänderungen beschreibt. Verwende null zum Entfernen einer Eigenschaft, gib { name: 'New name' } zum Umbenennen an oder übergib ein Eigenschafts-Schema-Objekt zum Ändern von Typ/Optionen
  • icon (TEXT, Optional): Emoji oder vollständiges Icon-Objekt
  • cover (TEXT, Optional): Externe Cover-URL oder vollständiges externes Datei-Objekt

Output: Gibt die aktualisierte Datenbank mit neuen Metadaten und Eigenschaften zurück

---

​

Seiten-Details abrufen

miro.getPageDetails

Ruft detaillierte Informationen über eine bestimmte Notion-Seite ab, einschließlich ihrer Eigenschaften, Metadaten und Struktur Benötigt Bestätigung: Nein Parameter:

• pageId (TEXT, Erforderlich): Die eindeutige Kennung der Notion-Seite, über die du Informationen abrufen möchtest

Output: Gibt Seiten-Details zurück, einschließlich ID, Titel, Eigenschaften und Metadaten

---

​

Seiten finden

miro.findPages

Sucht nach Seiten in deinem Notion-Workspace anhand des Titels Benötigt Bestätigung: Nein Parameter:

• query (TEXT, Optional): Suchbegriff zum Finden von Seiten anhand ihrer Titel

Output: Gibt ein Array von Seiten zurück, die den Suchkriterien entsprechen

---

​

Datenbanken finden

miro.findDatabases

Sucht nach Datenbanken in deinem Notion-Workspace anhand des Titels Benötigt Bestätigung: Nein Parameter:

• query (TEXT, Optional): Suchbegriff zum Finden von Datenbanken anhand ihrer Titel

Output: Gibt ein Array von Datenbanken zurück, die den Suchkriterien entsprechen

---

​

Datenbank-Details abrufen

miro.getDatabaseDetails

Ruft detaillierte Informationen über eine bestimmte Notion-Datenbank ab, einschließlich ihrer Eigenschaften, Metadaten und Struktur Benötigt Bestätigung: Nein Parameter:

• databaseId (TEXT, Erforderlich): Die eindeutige Kennung der Notion-Datenbank, über die du Informationen abrufen möchtest

Output: Gibt Datenbank-Details zurück, einschließlich ID, Titel, Eigenschaften-Schema und Metadaten

---

​

Suchen

miro.search

Durchsucht deinen gesamten Notion-Workspace oder eine bestimmte Datenbank nach Seiten und Inhalten Benötigt Bestätigung: Nein Parameter:

• query (TEXT, Optional): Suchbegriff zum Finden von Seiten oder Datenbanken. Suchen sind case-insensitive und treffen partielle Wörter
  • databaseId (TEXT, Optional): Optional: Innerhalb einer bestimmten Datenbank statt des gesamten Workspace suchen
  • objectType (SELECT, Optional): Ergebnisse nach Typ filtern. Wähle ‘page’ nur für Seiten oder ‘database’ nur für Datenbanken
  • propertyFilters (TEXT, Optional): Datenbank-Seiten nach Eigenschafts-Werten filtern (benötigt Datenbank-ID). Als JSON-Objekt angeben
  • pageSize (NUMBER, Optional): Anzahl der Ergebnisse pro Seite. Standard ist 30, Maximum ist 100
  • sortBy (SELECT, Optional): Ergebnisse nach Erstellungszeit oder letzter Bearbeitungszeit sortieren
  • sortDirection (SELECT, Optional): Sortierreihenfolge für Ergebnisse
  • createdBy (TEXT, Optional): Ergebnisse nach dem User filtern, der die Seite oder Datenbank erstellt hat
  • lastEditedBy (TEXT, Optional): Ergebnisse nach dem User filtern, der die Seite oder Datenbank zuletzt bearbeitet hat
  • startCursor (TEXT, Optional): Paginierungs-Cursor aus vorherigen Suchergebnissen

Output: Gibt ein Array von Seiten und Datenbanken zurück, die den Suchkriterien entsprechen

---

​

Seite erstellen

miro.createPage

Erstellt eine neue Seite in Notion, entweder als Datenbank-Eintrag oder als Kind einer anderen Seite Benötigt Bestätigung: Ja Parameter:

• parentId (TEXT, Erforderlich): Die ID der Eltern-Datenbank oder -Seite, wo die neue Seite erstellt wird
  • parentType (SELECT, Optional): Typ des Eltern-Elements, wo die Seite erstellt wird
  • title (TEXT, Optional): Der Titel der neuen Seite
  • properties (OBJECT, Optional): Eigenschaften für die neue Seite als JSON-Objekt
  • content (TEXT, Optional): Der Inhalt der Seite. Kann Klartext sein (wird in Absätze konvertiert) oder ein Array von Notion-Blöcken
  • icon (TEXT, Optional): Ein Emoji oder eine URL für das Seiten-Icon
  • cover (TEXT, Optional): URL eines Bildes als Seiten-Cover
  • createInPersonalRoot (BOOLEAN, Optional): Wenn aktiviert und parentId ist ‘workspace’ oder ‘root’, wird die Seite in deinem persönlichen Workspace-Root erstellt

Output: Gibt die erstellte Seite mit ID, Titel und Eigenschaften zurück

---

​

Seite aktualisieren

miro.updatePage

Aktualisiert die Eigenschaften einer Seite und/oder einen bestimmten Block auf dieser Seite. Verwende Seiten-Felder für Datenbank-/Seiten-Metadaten; verwende Block-Felder zum Bearbeiten des Inhalts eines einzelnen Blocks Benötigt Bestätigung: Ja Parameter:

• pageId (TEXT, Optional): ID der zu aktualisierenden Seite (Eigenschaften, Icon, Cover, Papierkorb)
  • properties (TEXT, Optional): JSON-Objekt der zu aktualisierenden Eigenschaften
  • icon (TEXT, Optional): Emoji-Zeichen oder vollständiges Notion-Icon-Objekt
  • cover (TEXT, Optional): URL-String oder vollständiges Notion-externes Datei-Objekt
  • inTrash (BOOLEAN, Optional): Auf true setzen, um die Seite in den Papierkorb zu verschieben, false zum Wiederherstellen
  • blockId (TEXT, Optional): ID des zu aktualisierenden Blocks (Inhalts-Bearbeitung)
  • blockType (TEXT, Optional): Zu aktualisierender Block-Typ (z.B. ‘paragraph’, ‘heading_1’, ‘heading_2’, ‘heading_3’, ‘to_do’, ‘bulleted_list_item’, ‘numbered_list_item’)
  • blockText (TEXT, Optional): Textinhalt für den Block (konvertiert zu rich_text)
  • blockChecked (BOOLEAN, Optional): Nur für to_do-Blöcke. true/false
  • blockPayload (TEXT, Optional): Erweitert: vollständiger JSON-Body für das Block-Update (überschreibt blockType/blockText)
  • blockArchived (BOOLEAN, Optional): Auf true setzen, um den Block zu archivieren, false zum De-archivieren

Output: Gibt die aktualisierte Seite oder den Block mit neuen Werten zurück

​

Triggers

---

​

Aktualisierte Seite

miro.updatedPage

Wird ausgelöst, wenn Seiten aktualisiert werden Benötigt Bestätigung: Nein Parameter:

• pageId (TEXT, Optional): ID der Seite, die auf Updates überwacht werden soll

Output: Gibt das Ergebnis des Vorgangs zurück

---

​

Aktualisiertes Datenbank-Element

miro.updatedDatabaseItem

Wird ausgelöst, wenn Elemente in der Datenbank aktualisiert werden Benötigt Bestätigung: Nein Parameter:

• databaseId (TEXT, Erforderlich): ID der Datenbank, die auf aktualisierte Elemente überwacht werden soll

Output: Gibt das Ergebnis des Vorgangs zurück

---

​

Neues Datenbank-Element

miro.newDatabaseItem

Wird ausgelöst, wenn neue Datenbank-Elemente hinzugefügt werden Benötigt Bestätigung: Nein Parameter:

• databaseId (TEXT, Erforderlich): ID der Datenbank, die auf neue Elemente überwacht werden soll

Output: Gibt das Ergebnis des Vorgangs zurück

---

​

Häufige Anwendungsfälle

​

Best Practices

​

Fehlerbehebung

Problem	Lösung
Authentifizierung fehlgeschlagen	Überprüfe deine OAuth-Anmeldedaten
Rate Limit überschritten	Reduziere die Anfrage-Häufigkeit
Daten nicht gefunden	Überprüfe Berechtigungen und Datenverfügbarkeit
Verbindungs-Timeout	Überprüfe die Netzwerk-Konnektivität

​

Support

Für weitere Hilfe mit der Miro-Integration kontaktiere support@langdock.com