Templates auflisten

Jedes Template der Connection, neueste zuerst, per Keyset paginiert.

export OE=https://api.openemail.ukexport AUTH="Authorization: Bearer $OPENEMAIL_API_KEY"

Ein Template ist ein einmal gespeicherter und vielfach versendeter Body, und es gehört der CONNECTION und nicht demjenigen, der es geschrieben hat. Ein Workspace-Schlüssel sieht dieselben Templates wie eine Kollegin, und das Löschen des Autorenkontos nimmt sie nicht mit.

engine: "blocks" speichert einen Baum, dessen Knotenarten die Exporte von @react-email/components sind (Section, Row, Column, Container, Text, Heading, Button, Link, Img, Hr, Markdown, CodeBlock und CodeInline) und dessen Props die dieser Komponenten sind. Er wird beim Hineinschreiben validiert, ein fehlerhafter Knoten ist also ein 422 auf dem schreibenden Aufruf statt einer kaputten E-Mail später.

engine: "html" speichert Markup, das Sie bereits haben, einmalig bereinigt beim Veröffentlichen der Version. Das ist die Wahl, wenn Ihre Templates react-email-Komponenten in Ihrem eigenen Repository sind: Rendern Sie die Komponente in Ihrem eigenen Build mit @react-email/render und posten Sie das Ergebnis. Es gibt keinen JSX-Endpunkt und wird keinen geben. Die API nimmt HTML, weil HTML das ist, was ein Mailclient liest, und das Ausführen einer fremden Komponente würde eine Sandbox erkaufen, die niemand braucht.

Beide werden im Body und im Betreff als {{key}} geschrieben, und beide tragen ein kind (text, url oder image), das entscheidet, wie der Wert beim Einsetzen escapt wird. Ein Schlüssel, den nichts deklariert, scheitert beim Veröffentlichen; ein url-Wert, dessen Schema nicht http, https oder mailto ist, wird abgelehnt statt gerendert.

Benötigt templates:read. limit geht bis 100, status schränkt auf draft, active oder archived ein, und cursor ist opak; geben Sie also den nextCursor zurück, den Sie erhalten haben, statt einen zu bauen.

curl "$OE/templates?limit=25&status=active" -H "$AUTH"

{  "object": "list",  "data": [    {      "object": "template",      "id": "tpl_9c1f0a4b7e05d3862c1f0a44",      "name": "Order shipped",      "slug": "order-shipped",      "description": null,      "status": "active",      "publishedVersion": 3,      "latestVersion": 4,      "createdAt": "2026-08-01T09:12:44.000Z",      "updatedAt": "2026-08-28T16:03:10.000Z"    }  ],  "hasMore": false,  "nextCursor": null}