Templates: Versões
Restaurar versão do template
Leva um template html de volta a uma versão anterior: html, texto e assunto. A própria restauração vira a versão mais nova, então você também pode desfazê-la.
https://g.sendcorex.com/v1/templatecommand: restore_template_versionRequer o escopo template:update na sua API key.
Até 20 chamadas por minuto por conta. Acima disso, o comando responde RATE_LIMITED.
Argumentos
template_idstringobrigatórioUm template html.
ex.:
"html_5f2c8a10-3d4e-4b6f-9a71-2c8e0d4b7a93"version_atstringobrigatórioO
version_atdo List Template Versions, como veio.ex.:
"2026-10-21T04:09:12.004Z"
Início 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);Resposta
{
"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 da resposta
template_idO id do template:
html_<uuid>,unlayer_<number>oucustom_<uuid>. Use-o em todos os outros comandos.typehtml(seu, enviado pela API),unlayer(criado no editor drag-and-drop) oucustom(criado no editor da Sendcorex).nameO nome que você deu a ele.
referenceUm código curto que também identifica o template no dashboard.
previewUma imagem do template, para templates dos editores.
nullpara templates html e para templates dos editores ainda não salvos.has_htmlfalsepara um template de editor que foi criado mas nunca salvo. Ele ainda não pode ser renderizado nem enviado.html_sizeTamanho do html, em bytes.
editabletruepara templates html: você pode atualizá-los, restaurá-los e excluí-los aqui. Templates dos editores são somente leitura pela API.created_at / updated_atISO 8601, UTC.
subjectO assunto padrão, ou
null. Pode ter variáveis.htmlO html.
nullpara um template de editor que nunca foi salvo.textA versão em texto puro, ou
null. Envie uma: alguns clientes e filtros preferem emails que a têm.
Erros
Erros no nível HTTP retornam type, code e message. Erros marcados com CMD voltam dentro do resultado do comando, com HTTP 200.
- 401
INVALID_API_KEYA API key não existe, foi revogada ou foi desativada no dashboard.
- 429
RATE_LIMITEDMais de 15 requisições/s ou 15 simultâneas para o mesmo IP + API key. Aguarde o número de segundos em Retry-After.
- CMD
MISSING_SCOPEA API key não tem o escopo de que este comando precisa.
- CMD
INVALID_ARGSUm argumento é inválido: um `template_id` malformado, `name` ou `html` ausente, um nome com mais de 255 caracteres, um `version_at` que não é RFC 3339…
- CMD
TEMPLATE_NOT_FOUNDO template não está na sua conta.
- CMD
TEMPLATE_READ_ONLYUm template Unlayer ou Custom: edite-o no editor do dashboard. Só templates html mudam pela API.
- CMD
VERSION_NOT_FOUNDEssa versão não existe. Só as últimas 10 são mantidas.
- CMD
RATE_LIMITEDEste comando foi chamado vezes demais no último minuto pela sua conta. Aguarde um minuto.
- CMD
INTERNALErro no servidor. O detalhe só é gravado no log do servidor.