Update Template Sharing
Enable or disable public sharing and duplication for a studio template
Published ·Updated
/v1/studio/templates/{templateId}/sharecurl -X POST "https://api.orshot.com/v1/studio/templates/<TEMPLATE_ID>/share" \
-H "Authorization: Bearer <ORSHOT_API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"enabled": true,
"allow_duplication": true
}'const res = await fetch("https://api.orshot.com/v1/studio/templates/<TEMPLATE_ID>/share", {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: "Bearer <ORSHOT_API_KEY>",
},
body: JSON.stringify({
"enabled": true,
"allow_duplication": true
}),
});
const data = await res.json();import requests
response = requests.post(
"https://api.orshot.com/v1/studio/templates/<TEMPLATE_ID>/share",
headers={"Authorization": "Bearer <ORSHOT_API_KEY>"},
json={
"enabled": True,
"allow_duplication": True
},
)
data = response.json()$ch = curl_init("https://api.orshot.com/v1/studio/templates/<TEMPLATE_ID>/share");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"Authorization: Bearer <ORSHOT_API_KEY>",
"Content-Type: application/json",
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
"enabled" => true,
"allow_duplication" => true
]));
$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>/share")
req = Net::HTTP::Post.new(uri)
req["Authorization"] = "Bearer <ORSHOT_API_KEY>"
req["Content-Type"] = "application/json"
req.body = {
"enabled": true,
"allow_duplication": true
}.to_json
res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(req) }
data = JSON.parse(res.body)Overview#
Turn public sharing on or off for a studio template, and control whether visitors can duplicate it. The response returns the public link, embed link and embed code, matching the studio's Share dialog.
The share link is minted once and stays stable: turning sharing off and back on brings the same link back to life, so anything you already shared keeps working.
https://api.orshot.com/v1/studio/templates/:templateId/sharePath Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
templateId | Integer | Yes | The unique ID of the studio template |
Request Body#
Both fields are optional. A field you leave out keeps its current value, so you can toggle duplication without touching the sharing state. Turning sharing off also turns duplication off. Turning sharing on never turns duplication on by itself. Send allow_duplication: true with it (paid plans only) to allow copies. Both fields must be booleans. A string such as "true" is rejected.
| Parameter | Type | Required | Description |
|---|---|---|---|
enabled | Boolean | No | Turn public sharing on or off |
allow_duplication | Boolean | No | Let visitors save a copy of the template to their own workspace. Requires a paid plan. Off by default. |
Request#
await fetch("https://api.orshot.com/v1/studio/templates/123/share", {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: "Bearer <ORSHOT_API_KEY>",
},
body: JSON.stringify({
enabled: true,
allow_duplication: true, // Optional, paid plans only
}),
});{
"enabled": true,
"allow_duplication": true,
"share_url": "https://orshot.com/templates/shared/k3n9xq2w/preview?view=play",
"embed_url": "https://orshot.com/templates/shared/k3n9xq2w/embed?view=play",
"embed_code": "<iframe src=\"https://orshot.com/templates/shared/k3n9xq2w/embed?view=play\" title=\"Orshot Embed\" allow=\"clipboard-write\" style=\"width: 100%; height: 100%; min-height: 500px; border: none; border-radius: 8px;\"></iframe>",
"stats": {
"views": 0,
"copies": 0
},
"created_at": "2026-07-11T08:05:18.491Z"
}Error Responses#
Invalid Value (400)#
Sent when enabled or allow_duplication is not a boolean.
{
"error": "'enabled' must be true or false (boolean, not a string)"
}Duplication Requires a Paid Plan (403)#
Sent when allow_duplication: true is requested on a free plan.
{
"error": "Allowing template duplication requires a paid plan",
"code": "duplication_paid_plan_required"
}Template Not Found (404)#
{
"error": "Studio template with ID '123' not found in your workspace"
}Notes#
- Disabling sharing makes the public page return an error, but keeps the underlying link. Re-enabling restores the exact same URLs.
- Share changes never trigger the
template.updateembed webhook, since the design itself did not change. allow_duplicationis always off while sharing is disabled. When you turn sharing back on, sendallow_duplication: trueagain if you want copies allowed.
Rate Limits#
- 30 requests per minute per API key, shared with the other studio template, folder and sharing endpoints
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