Eine Version veröffentlichen
Friert den aktuellen Entwurf ein und macht ihn zu dem, was ein Versand auflöst.
Führt den echten Aufruf gegen Ihren Workspace aus, mit Ihrem eigenen Schlüssel.
POST /templates/{id}/versions
Friert den aktuellen Entwurf ein und macht ihn zu dem, was ein Versand auflöst.
Beispiel
Benötigt templates:write. Ein POST auf die Versionssammlung, denn genau das legt er an. Liefert 201.
curl -X POST "$OE/templates/order-shipped/versions" -H "$AUTH"{ "object": "template_version", "id": "tplv_5d31c2a8…", "templateId": "tpl_9c1f0a4b7e05d3862c1f0a44", "version": 5, "state": "published", "engine": "html", "subject": "Order {{orderId}} is on its way", "slots": [], "props": [{ "key": "orderId", "kind": "text", "required": true, "default": null }], "publishedAt": "2026-08-30T11:02:19.000Z", "createdAt": "2026-08-30T10:58:04.000Z", "template": { "object": "template", "publishedVersion": 5, "latestVersion": 5 }}Der Body wird hier kompiliert und nicht erst beim Versand. Ein Template, das sich nicht rendern lässt, scheitert für die Person, die es veröffentlicht, und das ist der letzte Moment, in dem es vor jemandem scheitern kann, der es beheben kann.
Idempotent. Das Veröffentlichen eines bereits veröffentlichten Kopfes gibt ihn unverändert zurück, statt eine identische Version zu erzeugen; ein Deploy-Skript darf dies also bei jedem Lauf aufrufen.
Ein Body, der einen Schlüssel referenziert, den nichts deklariert, ist invalid_template, ein 422, und es wird nichts veröffentlicht.