Templates : Versions
Restaurer une version du modèle
Ramène un template html à une version antérieure : html, texte et objet. La restauration devient elle-même la version la plus récente, vous pouvez donc l'annuler aussi.
https://g.sendcorex.com/v1/templatecommand: restore_template_versionNécessite le scope template:update sur votre API key.
Jusqu'à 20 appels par minute et par compte. Au-delà, la commande répond RATE_LIMITED.
Arguments
template_idstringobligatoireUn template html.
ex. :
"html_5f2c8a10-3d4e-4b6f-9a71-2c8e0d4b7a93"version_atstringobligatoireLe
version_atissu de List Template Versions, tel quel.ex. :
"2026-10-21T04:09:12.004Z"
Démarrage rapide
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);Réponse
{
"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"
}
}
]
}Champs de la réponse
template_idL'id du template :
html_<uuid>,unlayer_<number>oucustom_<uuid>. Utilisez-le dans toutes les autres commandes.typehtml(le vôtre, envoyé via l'API),unlayer(créé dans l'éditeur drag-and-drop) oucustom(créé dans l'éditeur Sendcorex).nameLe nom que vous lui avez donné.
referenceUn code court qui identifie aussi le template dans le dashboard.
previewUne image du template, pour les templates des éditeurs.
nullpour les templates html et pour les templates d'éditeur pas encore enregistrés.has_htmlfalsepour un template d'éditeur créé mais jamais enregistré. Il ne peut pas encore être rendu ni envoyé.html_sizeTaille du html, en octets.
editabletruepour les templates html : vous pouvez les modifier, les restaurer et les supprimer ici. Les templates des éditeurs sont en lecture seule via l'API.created_at / updated_atISO 8601, UTC.
subjectL'objet par défaut, ou
null. Peut contenir des variables.htmlLe html.
nullpour un template d'éditeur jamais enregistré.textLa version texte brut, ou
null. Fournissez-en une : certains clients et filtres préfèrent les e-mails qui en ont une.
Erreurs
Les erreurs au niveau HTTP renvoient type, code et message. Les erreurs marquées CMD reviennent dans le résultat de la commande, avec HTTP 200.
- 401
INVALID_API_KEYL'API key n'existe pas, a été révoquée ou a été désactivée dans le dashboard.
- 429
RATE_LIMITEDPlus de 15 requêtes/s ou 15 simultanées pour la même IP + API key. Attendez le nombre de secondes indiqué dans Retry-After.
- CMD
MISSING_SCOPEL'API key n'a pas le scope dont cette commande a besoin.
- CMD
INVALID_ARGSUn argument est invalide : un `template_id` mal formé, un `name` ou un `html` manquant, un nom de plus de 255 caractères, un `version_at` qui n'est pas au format RFC 3339…
- CMD
TEMPLATE_NOT_FOUNDLe template n'existe pas dans votre compte.
- CMD
TEMPLATE_READ_ONLYUn template Unlayer ou Custom : modifiez-le dans l'éditeur du dashboard. Seuls les templates html se modifient via l'API.
- CMD
VERSION_NOT_FOUNDCette version n'existe pas. Seules les 10 dernières sont conservées.
- CMD
RATE_LIMITEDVotre compte a appelé cette commande trop de fois au cours de la dernière minute. Attendez une minute.
- CMD
INTERNALErreur serveur. Le détail n'est écrit que dans le log du serveur.