Delete Template Version

Remove one version from a template's timeline

Updated

DELETE
/v1/studio/templates/{templateId}/versions/{versionId}
curl -X DELETE "https://api.orshot.com/v1/studio/templates/<TEMPLATE_ID>/versions/<VERSION_ID>" \
  -H "Authorization: Bearer <ORSHOT_API_KEY>"

Deletes one version. Deleting a named version frees one of the plan's named slots. The live template is not affected.

Endpoint#

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

URL Parameters#

ParameterTypeRequiredDescription
templateIdIntegerYesID of the studio template
versionIdIntegerYesID of the version

Request#

JavaScript
await fetch("https://api.orshot.com/v1/studio/templates/12345/versions/48", {
  method: "DELETE",
  headers: { Authorization: "Bearer <ORSHOT_API_KEY>" },
});
JSON
{ "success": true, "id": 48 }

Error Responses#

Status CodeCodeDescription
400invalid_version_idversionId is not a numeric id
403enterprise_requiredAPI key without the Enterprise version history feature
404VERSION_NOT_FOUNDNo such version on this template
500DELETE_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