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
}

If your embed has a signing secret, the request includes an X-Orshot-Signature header. See Verify Webhook Signatures.

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, shared with the other studio template, folder and sharing endpoints
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