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.

POSThttps://g.sendcorex.com/v1/templatecommand: list_template_versions
i

Nécessite le scope template:read sur votre API key.

i

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_idstringobligatoire

    Le 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_id

    Le template.

  • versions

    De la plus récente à la plus ancienne. Vide si rien n'a encore été enregistré.

  • versions[].version_at

    Quand la version a été enregistrée. Passez-la telle quelle à Restore Template Version.

  • versions[].html_size

    Taille du html de cette version, en octets.

  • versions[].subject

    L'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.

  • 401INVALID_API_KEY

    L'API key n'existe pas, a été révoquée ou a été désactivée dans le dashboard.

  • 429RATE_LIMITED

    Plus 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.

  • CMDMISSING_SCOPE

    L'API key n'a pas le scope dont cette commande a besoin.

  • CMDINVALID_ARGS

    Un 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…

  • CMDTEMPLATE_NOT_FOUND

    Le template n'existe pas dans votre compte.

  • CMDINTERNAL

    Erreur serveur. Le détail n'est écrit que dans le log du serveur.