Move Template to Folder

Move a studio template into a folder, or out of its current folder

Published

PATCH
/v1/studio/templates/{templateId}/folder
curl -X PATCH "https://api.orshot.com/v1/studio/templates/<TEMPLATE_ID>/folder" \
  -H "Authorization: Bearer <ORSHOT_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "folder_id": 1
  }'

Overview#

Assign a studio template to a folder, or pass null to move it out of its current folder back to "All templates".

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

Path Parameters#

ParameterTypeRequiredDescription
templateIdIntegerYesThe unique ID of the studio template

Request Body#

ParameterTypeRequiredDescription
folder_idInteger or nullYesTarget folder ID, or null to remove the template from its folder

Request#

JavaScript
await fetch("https://api.orshot.com/v1/studio/templates/123/folder", {
  method: "PATCH",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer <ORSHOT_API_KEY>",
  },
  body: JSON.stringify({
    folder_id: 11, // or null to move it out
  }),
});
JSON
{
  "success": true,
  "template_id": 123,
  "folder_id": 11
}

Error Responses#

Folder Not in Your Workspace (400)#

JSON
{
  "error": "Folder not found in this workspace"
}

Missing folder_id (400)#

JSON
{
  "error": "folder_id is required (use null to remove from its folder)"
}

Template Not Found (404)#

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

Notes#

  • Folder moves are organization only. They never trigger the template.update embed webhook.
  • To move several templates, call this endpoint once per template.

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 50+ integrations
  • White-label embed for your own app
  • 30 free credits — no credit card required