API

バージョンを公開する

現在の下書きを凍結し、送信が解決する対象にします。

POSTapi.openemail.uk/templates/{id}/versions

実際の呼び出しを、ご自身のキーで自分のワークスペースに対して実行します。

POST /templates/{id}/versions

現在の下書きを凍結し、送信が解決する対象にします。

例

templates:write が必要です。作られるのはバージョンなので、バージョンコレクションへの POST です。201 を返します。

curl

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 }}

本文は送信時ではなくここでコンパイルされます。描画できないテンプレートは公開した本人の目の前で失敗します。それが、修正できる人の前で失敗できる最後の瞬間だからです。

冪等です。すでに公開済みの先頭を公開しても、同一のバージョンを新たに作るのではなく、そのまま返します。そのためデプロイスクリプトは実行のたびにこれを呼んで構いません。

どこにも宣言されていないキーを参照する本文は invalid_template（422）となり、何も公開されません。