REST-API-Referenz
Öffentliche REST-API für programmatischen Lesezugriff auf Metapad-Modelle. Alle Endpunkte erfordern ein API-Token (mpt_...) oder OAuth-JWT. Pro+-Plan erforderlich.
/api/v1/models/{model_id}RESTModell abrufen
Gibt die vollständigen Modelldaten einschließlich Metamodell (M2-Typen) und aller Knoten-/Beziehungsinstanzen zurück. Entspricht einem vollständigen JSON-Export.
/api/v1/models/{model_id}/relationshipsRESTBeziehungen auflisten
Paginierte Liste von Beziehungen mit Filterung nach Typ, Quell- oder Zielknoten. Gibt x-total-count-Header für die Paginierung zurück.
/api/v1/models/{model_id}/exportRESTModell exportieren
Das vollständige Modell als herunterladbare JSON-Datei exportieren. Identische Daten wie bei „Modell abrufen", aber mit Content-Disposition: attachment für direkten Download.
/api/v1/models/{model_id}/metadataRESTMetadaten abrufen
Leichtgewichtige Modell-Metadaten: Name, Beschreibung, Sprachliste, Knoten-/Beziehungsanzahlen und Zeitstempel der letzten Aktualisierung. Gibt keine Modellinhalte zurück.
/api/v1/models/{model_id}/foldersRESTOrdner auflisten
Gibt die vollständige Ordnerhierarchie für das Modell zurück. Ordner sind optionale Organisationscontainer für Knoten.
/api/v1/models/{model_id}/nodes/batchRESTKnoten stapelweise abrufen
Mehrere Knoten per ID in einer einzigen Anfrage abrufen. Effizienter als mehrere Einzelknoten-Aufrufe. Akzeptiert UUIDs und Auto-IDs (z. B. REQ-42).
/api/v1/models/{model_id}/nodes/{node_id}RESTKnoten abrufen
Vollständige Details für einen einzelnen Knoten einschließlich aller Eigenschaften und optional seiner ein- und ausgehenden Beziehungen. Akzeptiert UUID oder Auto-ID (z. B. REQ-42).
/api/v1/models/{model_id}/nodesRESTKnoten auflisten
Paginierte Liste von Knoteninstanzen mit Filterung nach Typ, Ordner und Volltextsuche. Gibt eine Seite mit Knotenzusammenfassungen plus x-total-count-Header für die Paginierung zurück.
/api/v1/models/{model_id}/schemaRESTSchema abrufen
Gibt das Metamodell (M2-Schema) zurück: alle Knotentypen, Beziehungstypen, deren Eigenschaften und erlaubte Verbindungsmuster. Entspricht dem MCP-Tool get_metamodel.