Templates : Versions
Lister les versions du modèle
Les versions enregistrées d'un template, de la plus récente à la plus ancienne. Les 10 dernières sont conservées.
https://g.sendcorex.com/v1/templatecommand: list_template_versionsNécessite le scope template:read sur votre API key.
Les templates html enregistrent une version à chaque création et modification. Les templates d'éditeur en enregistrent une à chaque clic sur Enregistrer dans le dashboard (pas lors de l'enregistrement automatique).
Arguments
template_idstringobligatoireLe template.
ex. :
"html_5f2c8a10-3d4e-4b6f-9a71-2c8e0d4b7a93"
Démarrage rapide
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/template',
{
commands: [
{
command: "list_template_versions",
args: {
template_id: "html_5f2c8a10-3d4e-4b6f-9a71-2c8e0d4b7a93"
}
}
]
},
{ 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": "list_template_versions",
"id": "0",
"type": "SUCCESS",
"took_ms": 4,
"data": {
"template_id": "html_5f2c8a10-3d4e-4b6f-9a71-2c8e0d4b7a93",
"versions": [
{
"version_at": "2026-10-21T04:15:40.902Z",
"html_size": 248,
"subject": "Welcome to Acme, {{first_name}}"
},
{
"version_at": "2026-10-21T04:09:12.004Z",
"html_size": 231,
"subject": "Welcome to Acme"
},
{
"version_at": "2026-10-21T04:02:11.310Z",
"html_size": 198,
"subject": null
}
]
}
}
]
}Champs de la réponse
template_idLe template.
versionsDe la plus récente à la plus ancienne. Vide si rien n'a encore été enregistré.
versions[].version_atQuand la version a été enregistrée. Passez-la telle quelle à Restore Template Version.
versions[].html_sizeTaille du html de cette version, en octets.
versions[].subjectL'objet de cette version, ou
null.
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
INTERNALErreur serveur. Le détail n'est écrit que dans le log du serveur.