Delete Studio Template
Learn how to delete a studio template from your workspace
Updated
DELETE
/v1/studio/templates/{templateId}/deletecurl -X DELETE "https://api.orshot.com/v1/studio/templates/<TEMPLATE_ID>/delete" \
-H "Authorization: Bearer <ORSHOT_API_KEY>"const res = await fetch("https://api.orshot.com/v1/studio/templates/<TEMPLATE_ID>/delete", {
method: "DELETE",
headers: {
Authorization: "Bearer <ORSHOT_API_KEY>",
},
});
const data = await res.json();import requests
response = requests.delete(
"https://api.orshot.com/v1/studio/templates/<TEMPLATE_ID>/delete",
headers={"Authorization": "Bearer <ORSHOT_API_KEY>"},
)
data = response.json()$ch = curl_init("https://api.orshot.com/v1/studio/templates/<TEMPLATE_ID>/delete");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"Authorization: Bearer <ORSHOT_API_KEY>",
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);require "net/http"
require "json"
uri = URI("https://api.orshot.com/v1/studio/templates/<TEMPLATE_ID>/delete")
req = Net::HTTP::Delete.new(uri)
req["Authorization"] = "Bearer <ORSHOT_API_KEY>"
res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(req) }
data = JSON.parse(res.body)Overview#
This endpoint allows you to delete a specific studio template from your workspace using its unique ID.
https://api.orshot.com/v1/studio/templates/:templateId/deleteRequest#
await fetch("https://api.orshot.com/v1/studio/templates/123/delete", {
method: "DELETE",
headers: {
"Content-Type": "application/json",
Authorization: "Bearer <ORSHOT_API_KEY>",
},
});{
"message": "Template successfully deleted",
"id": "123"
}Path Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
templateId | Integer | Yes | The 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.
{
"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)#
{
"error": "Studio template with ID '123' not found in your workspace"
}Missing Template ID (400)#
{
"error": "'templateId' is missing in the request parameters"
}Unauthorized (403)#
{
"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