Delete Studio Template

Learn how to delete a studio template from your workspace

Updated

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

Overview#

This endpoint allows you to delete a specific studio template from your workspace using its unique ID.

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

Request#

JavaScript
await fetch("https://api.orshot.com/v1/studio/templates/123/delete", {
  method: "DELETE",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer <ORSHOT_API_KEY>",
  },
});
JSON
{
  "message": "Template successfully deleted",
  "id": "123"
}

Path Parameters#

ParameterTypeRequiredDescription
templateIdIntegerYesThe unique identifier of the studio template to delete

Webhook#

If your workspace has embedded studio with a webhook_url configured, a template.delete event will be sent automatically when a template is deleted.

JSON
{
  "event_type": "template.delete",
  "template": {
    "id": 123,
    "name": "My Template",
    "workspace_id": "890"
  },
  "timestamp": "2026-02-17T12:00:00.000Z",
  "workspace_id": "890"
}

Error Responses#

Template Not Found (404)#

JSON
{
  "error": "Studio template with ID '123' not found in your workspace"
}

Missing Template ID (400)#

JSON
{
  "error": "'templateId' is missing in the request parameters"
}

Unauthorized (403)#

JSON
{
  "error": "Access Forbidden: Invalid API Key"
}

Notes#

  • The template must belong to your workspace
  • Once deleted, templates cannot be recovered
  • The API key must have the appropriate permissions to delete templates

Rate Limits#

  • 30 requests per minute per API key
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 40+ integrations
  • White-label embed for your own app
  • 100 free credits a month, no credit card required