Templates: Versionen
Vorlagenversion wiederherstellen
Setzt ein html-Template auf eine frühere Version zurück: html, Text und Betreff. Die Wiederherstellung selbst wird zur neuesten Version, sodass Sie sie auch rückgängig machen können.
https://g.sendcorex.com/v1/templatecommand: restore_template_versionErfordert den Scope template:update für Ihren API key.
Bis zu 20 Aufrufe pro Minute und Konto. Darüber antwortet der Befehl mit RATE_LIMITED.
Argumente
template_idstringerforderlichEin html-Template.
z. B.
"html_5f2c8a10-3d4e-4b6f-9a71-2c8e0d4b7a93"version_atstringerforderlichDas
version_ataus List Template Versions, unverändert.z. B.
"2026-10-21T04:09:12.004Z"
Schnellstart
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/template',
{
commands: [
{
command: "restore_template_version",
args: {
template_id: "html_5f2c8a10-3d4e-4b6f-9a71-2c8e0d4b7a93",
version_at: "2026-10-21T04:09:12.004Z"
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_API_KEY } },
);
const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);Antwort
{
"type": "SUCCESS",
"results": [
{
"command": "restore_template_version",
"id": "0",
"type": "SUCCESS",
"took_ms": 11,
"data": {
"template_id": "html_5f2c8a10-3d4e-4b6f-9a71-2c8e0d4b7a93",
"type": "html",
"name": "Welcome email",
"reference": "K7Q2M9XR4T",
"preview": null,
"has_html": true,
"html_size": 248,
"editable": true,
"created_at": "2026-10-21T04:02:11.310Z",
"updated_at": "2026-10-21T04:40:02.118Z",
"subject": "Welcome to Acme",
"html": "<!doctype html><html><body style=\"font-family:Arial,sans-serif\"><h1>Welcome, {{first_name}}!</h1><p>Your {{plan}} plan is ready.</p><p><a href=\"https://acme.com/start\">Get started</a></p></body></html>",
"text": "Welcome, {{first_name}}! Your {{plan}} plan is ready. Get started: https://acme.com/start"
}
}
]
}Antwortfelder
template_idDie ID des Templates:
html_<uuid>,unlayer_<number>odercustom_<uuid>. Verwenden Sie sie in allen anderen Befehlen.typehtml(Ihres, über die API gesendet),unlayer(im Drag-and-drop-Editor erstellt) odercustom(im Sendcorex-Editor erstellt).nameDer Name, den Sie ihm gegeben haben.
referenceEin kurzer Code, der das Template auch im Dashboard identifiziert.
previewEin Bild des Templates, bei Editor-Templates.
nullbei html-Templates und bei noch nicht gespeicherten Editor-Templates.has_htmlfalsebei einem Editor-Template, das erstellt, aber nie gespeichert wurde. Es kann noch nicht gerendert oder gesendet werden.html_sizeGröße des html in Bytes.
editabletruebei html-Templates: Sie können sie hier aktualisieren, wiederherstellen und löschen. Editor-Templates sind über die API schreibgeschützt.created_at / updated_atISO 8601, UTC.
subjectDer Standardbetreff oder
null. Kann Variablen enthalten.htmlDas html.
nullbei einem Editor-Template, das nie gespeichert wurde.textDie Nur-Text-Version oder
null. Senden Sie eine mit: Manche Clients und Filter bevorzugen E-Mails, die eine haben.
Fehler
Fehler auf HTTP-Ebene liefern type, code und message. Mit CMD markierte Fehler kommen im Befehlsergebnis zurück, mit HTTP 200.
- 401
INVALID_API_KEYDer API key existiert nicht, wurde widerrufen oder im Dashboard deaktiviert.
- 429
RATE_LIMITEDMehr als 15 Requests/s oder 15 gleichzeitig für dieselbe IP + API key. Warten Sie die Anzahl Sekunden aus Retry-After ab.
- CMD
MISSING_SCOPEDer API key hat nicht den Scope, den dieser Befehl braucht.
- CMD
INVALID_ARGSEin Argument ist ungültig: eine fehlerhafte `template_id`, fehlendes `name` oder `html`, ein Name über 255 Zeichen, ein `version_at`, das nicht RFC 3339 entspricht…
- CMD
TEMPLATE_NOT_FOUNDDas Template ist nicht in Ihrem Konto.
- CMD
TEMPLATE_READ_ONLYEin Unlayer- oder Custom-Template: Bearbeiten Sie es im Dashboard-Editor. Nur html-Templates lassen sich über die API ändern.
- CMD
VERSION_NOT_FOUNDDiese Version existiert nicht. Nur die letzten 10 werden aufbewahrt.
- CMD
RATE_LIMITEDIhr Konto hat diesen Befehl in der letzten Minute zu oft aufgerufen. Warten Sie eine Minute.
- CMD
INTERNALServerfehler. Details werden nur ins Server-Log geschrieben.