Templates: Bearbeiten
Template aktualisieren
Ändert Name, html, Text oder Betreff eines html-Templates. Jede Änderung speichert eine Version, damit Sie zurückgehen können: Die letzten 10 werden aufbewahrt.
https://g.sendcorex.com/v1/templatecommand: update_templateErfordert den Scope template:update für Ihren API key.
Bis zu 60 Aufrufe pro Minute und Konto. Darüber antwortet der Befehl mit RATE_LIMITED.
Senden Sie nur, was sich ändert. text oder subject als null oder "" leert das Feld.
Unlayer- und Custom-Templates antworten mit TEMPLATE_READ_ONLY: Bearbeiten Sie sie im Dashboard.
Argumente
template_idstringerforderlichEin html-Template.
z. B.
"html_5f2c8a10-3d4e-4b6f-9a71-2c8e0d4b7a93"namestringoptionalBis zu 255 Zeichen, kein HTML.
z. B.
"Welcome email v2"htmlstringoptionalDas neue html, bis zu 512 KB. Wird wie bei Create Template geprüft.
textstring | nulloptionalDie neue Nur-Text-Version.
subjectstring | nulloptionalDer neue Standardbetreff.
z. B.
"Welcome aboard, {{first_name}}"
Schnellstart
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/template',
{
commands: [
{
command: "update_template",
args: {
template_id: "html_5f2c8a10-3d4e-4b6f-9a71-2c8e0d4b7a93",
subject: "Welcome aboard, {{first_name}}"
}
}
]
},
{ 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": "update_template",
"id": "0",
"type": "SUCCESS",
"took_ms": 8,
"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:31:08.447Z",
"subject": "Welcome aboard, {{first_name}}",
"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.
Templates in Ihrem Repo halten
Eine Quelle der WahrheitHalten Sie das html in Ihrem Code und rufen Sie Update Template aus Ihrem Deploy auf. Ihr Team reviewt Templates wie jede andere Änderung.
Sichere RollbacksWenn ein Deploy ein Template kaputt macht, holt Restore Template Version die letzte funktionierende Version mit einem Aufruf zurück.
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
UNSAFE_HTMLDas html enthält etwas, das eine E-Mail nicht transportieren kann: `<script>`, `<iframe>`, Formulare, `on*=`-Handler, `javascript:`-Links… Die Meldung sagt genau, was zu entfernen ist.
- CMD
TEMPLATE_TOO_LARGEDas html ist größer als 512 KB. Hosten und verlinken Sie Ihre Bilder, statt sie einzubetten.
- 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.