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
}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)#
{
"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, 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