Restore a template version

POST/v1/templates/{name}/restoreAPI key

Copies the subject, HTML, text and variables of an older version into a new version. History is never rewritten: restoring version 2 of a template that is at version 5 creates version 6 with the content of version 2. Sends use it straight away.

Like Update a template, this fails with 409 template_conflict if the template changes while the restore runs.

Path parameters

namestringpathrequired

The template name.

Body parameters

versionnumberrequired

The version to restore, a whole number from 1. See List template versions.

Response

The template at its new version. Same fields as Retrieve a template.

Errors

Status	Code	When
400	`missing_body`	The request has no body.
400	`invalid_body`	`version` is missing or not a whole number of at least 1.
404	`template_not_found`	No stored template with this name. Built-in templates also return this.
404	`template_version_not_found`	The template has no such version.
409	`template_conflict`	The template changed while the restore ran.

Request

import { Flaresend } from '@flaresend/client';

const flaresend = new Flaresend({
  apiKey: process.env.FLARESEND_API_KEY!,
  baseUrl: 'https://mailer.example.com',
});

const template = await flaresend.templates.restore('order-shipped', 2);

Response

{
  "id": "tmpl_01K6B5A7C9E1G3J5L7N9Q1S3U5",
  "source": "db",
  "projectId": "proj_01K6A9W2E4R6T8Y0U2I4O6P8A0",
  "name": "order-shipped",
  "subject": "Good news: order {{order.number}} has shipped",
  "html": "<p>Hi {{first_name}}, your order has shipped.</p>",
  "text": null,
  "variables": [
    { "name": "first_name", "required": true, "example": "Ada" }
  ],
  "version": 6,
  "createdAt": "2026-09-26T10:00:00.000Z",
  "updatedAt": "2026-09-30T08:45:00.000Z"
}

Path parametersCopy Anchor Link

Body parametersCopy Anchor Link

ResponseCopy Anchor Link

ErrorsCopy Anchor Link

Path parameters

Body parameters

Response

Errors