Templates: Versiones
Restaurar versión de la plantilla
Devuelve un template html a una versión anterior: html, texto y asunto. La propia restauración se convierte en la versión más reciente, así que también puedes deshacerla.
https://g.sendcorex.com/v1/templatecommand: restore_template_versionRequiere el scope template:update en tu API key.
Hasta 20 llamadas por minuto por cuenta. Por encima, el comando responde RATE_LIMITED.
Argumentos
template_idstringobligatorioUn template html.
p. ej.
"html_5f2c8a10-3d4e-4b6f-9a71-2c8e0d4b7a93"version_atstringobligatorioEl
version_atde List Template Versions, tal como vino.p. ej.
"2026-10-21T04:09:12.004Z"
Inicio rápido
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);Respuesta
{
"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"
}
}
]
}Campos de la respuesta
template_idEl id del template:
html_<uuid>,unlayer_<number>ocustom_<uuid>. Úsalo en todos los demás comandos.typehtml(tuyo, enviado por la API),unlayer(creado en el editor drag-and-drop) ocustom(creado en el editor de Sendcorex).nameEl nombre que le diste.
referenceUn código corto que también identifica el template en el dashboard.
previewUna imagen del template, para los templates de los editores.
nullpara los templates html y para los de editor aún no guardados.has_htmlfalsepara un template de editor que se creó pero nunca se guardó. Todavía no se puede renderizar ni enviar.html_sizeTamaño del html, en bytes.
editabletruepara los templates html: puedes actualizarlos, restaurarlos y eliminarlos aquí. Los templates de los editores son de solo lectura a través de la API.created_at / updated_atISO 8601, UTC.
subjectEl asunto por defecto, o
null. Puede tener variables.htmlEl html.
nullpara un template de editor que nunca se guardó.textLa versión en texto plano, o
null. Envía una: algunos clientes y filtros prefieren los emails que la tienen.
Errores
Los errores a nivel HTTP devuelven type, code y message. Los errores marcados con CMD vuelven dentro del resultado del comando, con HTTP 200.
- 401
INVALID_API_KEYLa API key no existe, fue revocada o se desactivó en el dashboard.
- 429
RATE_LIMITEDMás de 15 solicitudes/s o 15 simultáneas para la misma IP + API key. Espera el número de segundos indicado en Retry-After.
- CMD
MISSING_SCOPELa API key no tiene el scope que necesita este comando.
- CMD
INVALID_ARGSUn argumento no es válido: un `template_id` mal formado, falta `name` o `html`, un nombre de más de 255 caracteres, un `version_at` que no es RFC 3339…
- CMD
TEMPLATE_NOT_FOUNDEl template no está en tu cuenta.
- CMD
TEMPLATE_READ_ONLYUn template Unlayer o Custom: edítalo en el editor del dashboard. Solo los templates html cambian a través de la API.
- CMD
VERSION_NOT_FOUNDEsa versión no existe. Solo se conservan las últimas 10.
- CMD
RATE_LIMITEDTu cuenta llamó a este comando demasiadas veces en el último minuto. Espera un minuto.
- CMD
INTERNALError del servidor. El detalle solo se escribe en el log del servidor.