Een versie publiceren
Bevriest het huidige concept en maakt het tot wat een verzending oplost.
Voert de echte aanroep uit op je workspace, met je eigen sleutel.
POST /templates/{id}/versions
Bevriest het huidige concept en maakt het tot wat een verzending oplost.
Voorbeeld
Vereist templates:write. Een POST naar de versiecollectie, want dat is wat hij aanmaakt. Geeft 201 terug.
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 }}De body wordt hier gecompileerd en niet op het moment van verzenden. Een template die niet rendert faalt voor degene die publiceert, en dat is het laatste moment waarop hij kan falen waar iemand bij is die het kan repareren.
Idempotent. Een al gepubliceerde head publiceren geeft hem ongewijzigd terug in plaats van een identieke versie te slaan, dus een deploy-script mag dit bij elke run aanroepen.
Een body die verwijst naar een sleutel die nergens wordt gedeclareerd is invalid_template, een 422, en er wordt niets gepubliceerd.