Templates: Mengedit
Perbarui template
Mengubah nama, html, teks, atau subjek template html. Setiap perubahan menyimpan versi agar Anda bisa kembali: 10 versi terakhir disimpan.
https://g.sendcorex.com/v1/templatecommand: update_templateMembutuhkan scope template:update pada API key Anda.
Hingga 60 panggilan per menit per akun. Jika lebih, perintah menjawab RATE_LIMITED.
Kirim hanya yang berubah. text atau subject bernilai null atau "" akan mengosongkannya.
Template Unlayer dan Custom menjawab TEMPLATE_READ_ONLY: edit di dashboard.
Argumen
template_idstringwajibTemplate html.
mis.
"html_5f2c8a10-3d4e-4b6f-9a71-2c8e0d4b7a93"namestringopsionalHingga 255 karakter, tanpa HTML.
mis.
"Welcome email v2"htmlstringopsionalhtml baru, hingga 512 KB. Diperiksa seperti di Create Template.
textstring | nullopsionalVersi teks biasa yang baru.
subjectstring | nullopsionalSubjek default yang baru.
mis.
"Welcome aboard, {{first_name}}"
Mulai cepat
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);Respons
{
"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"
}
}
]
}Field respons
template_idid template:
html_<uuid>,unlayer_<number>, ataucustom_<uuid>. Gunakan di semua perintah lain.typehtml(milik Anda, dikirim lewat API),unlayer(dibuat di editor drag-and-drop), ataucustom(dibuat di editor Sendcorex).nameNama yang Anda berikan.
referenceKode pendek yang juga mengidentifikasi template di dashboard.
previewGambar template, untuk template editor.
nulluntuk template html dan template editor yang belum disimpan.has_htmlfalseuntuk template editor yang sudah dibuat tetapi belum pernah disimpan. Template ini belum bisa dirender atau dikirim.html_sizeUkuran html, dalam byte.
editabletrueuntuk template html: Anda bisa memperbarui, memulihkan, dan menghapusnya di sini. Template editor hanya bisa dibaca melalui API.created_at / updated_atISO 8601, UTC.
subjectSubjek default, atau
null. Bisa berisi variabel.htmlhtml-nya.
nulluntuk template editor yang belum pernah disimpan.textVersi teks biasa, atau
null. Sertakan satu: beberapa klien dan filter lebih menyukai email yang memilikinya.
Menyimpan template di repo Anda
Satu sumber kebenaranSimpan html di kode Anda, lalu panggil Update Template dari deploy Anda. Tim Anda me-review template seperti perubahan lainnya.
Rollback yang amanJika deploy merusak template, Restore Template Version mengembalikan versi terakhir yang baik dalam satu panggilan.
Error
Error di level HTTP mengembalikan type, code, dan message. Error yang ditandai CMD dikembalikan di dalam hasil perintah, dengan HTTP 200.
- 401
INVALID_API_KEYAPI key tidak ada, telah dicabut, atau dinonaktifkan di dashboard.
- 429
RATE_LIMITEDLebih dari 15 request/dtk atau 15 bersamaan untuk IP + API key yang sama. Tunggu sejumlah detik yang ada di Retry-After.
- CMD
MISSING_SCOPEAPI key tidak memiliki scope yang dibutuhkan perintah ini.
- CMD
INVALID_ARGSAda argumen yang tidak valid: `template_id` yang salah format, `name` atau `html` tidak ada, nama lebih dari 255 karakter, `version_at` yang bukan RFC 3339…
- CMD
TEMPLATE_NOT_FOUNDTemplate tidak ada di akun Anda.
- CMD
TEMPLATE_READ_ONLYTemplate Unlayer atau Custom: edit di editor dashboard. Hanya template html yang bisa diubah melalui API.
- CMD
UNSAFE_HTMLhtml berisi sesuatu yang tidak bisa dibawa email: `<script>`, `<iframe>`, formulir, handler `on*=`, link `javascript:`… Pesannya menyebutkan persis apa yang harus dihapus.
- CMD
TEMPLATE_TOO_LARGEhtml lebih dari 512 KB. Host gambar Anda dan tautkan, jangan disematkan.
- CMD
RATE_LIMITEDAkun Anda memanggil perintah ini terlalu sering dalam satu menit terakhir. Tunggu satu menit.
- CMD
INTERNALError server. Detailnya hanya ditulis ke log server.