Copy a Version to a New Template

Create a new template from an earlier version without touching the live template

Updated

POST
/v1/studio/templates/{templateId}/versions/{versionId}/duplicate
curl -X POST "https://api.orshot.com/v1/studio/templates/<TEMPLATE_ID>/versions/<VERSION_ID>/duplicate" \
  -H "Authorization: Bearer <ORSHOT_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "<NAME>"
  }'

Creates a new template in the same workspace from the version's design, so an old design can be reused while the live template keeps going. The same plan rules as restore apply.

Endpoint#

Endpoint
https://api.orshot.com/v1/studio/templates/:templateId/versions/:versionId/duplicate

URL Parameters#

ParameterTypeRequiredDescription
templateIdIntegerYesID of the studio template
versionIdIntegerYesID of the version to copy

Request Body#

FieldTypeRequiredDescription
nameStringNoName of the new template. Default: <template name> (<version label or vN>)

Request#

JavaScript
await fetch(
  "https://api.orshot.com/v1/studio/templates/12345/versions/48/duplicate",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      Authorization: "Bearer <ORSHOT_API_KEY>",
    },
    body: JSON.stringify({ name: "Launch banner (spring edition)" }),
  },
);
JSON
{
  "success": true,
  "template": {
    "id": 12399,
    "name": "Launch banner (spring edition)",
    "updated_at": "2026-09-15T11:45:02.004+00:00",
    "workspace_id": 50
  },
  "from": { "id": 48, "number": 9, "kind": "session", "label": null }
}

Error Responses#

Status CodeCodeDescription
400invalid_namename is empty, not a string, or longer than 255 characters
400invalid_version_idversionId is not a numeric id
403PLAN_LOCKEDCopying versions needs a paid workspace plan
403PLAN_REACHThis version is older than the plan can restore
403enterprise_requiredAPI key without the Enterprise version history feature
404VERSION_NOT_FOUNDNo such version on this template
500COPY_FAILEDServer-side error
Was this page helpful?

Ready to automate?

Start rendering images, PDFs and videos from your templates in under 2 minutes. Free plan, no credit card.

Get your API key
  • Image, PDF and video generation via API
  • Visual editor with AI and smart layouts
  • Zapier, Make, MCP and 50+ integrations
  • White-label embed for your own app
  • 30 free credits — no credit card required