Update Template

Update template name and description

Command Palette

Search for a command to run...

Update the metadata of an existing studio template, including its name and description. This is a lightweight endpoint for updating template metadata without modifying the template structure or content.

Endpoint

https://api.orshot.com/v1/studio/templates/:templateId/update

Request Examples

// Update only the template name
await fetch("https://api.orshot.com/v1/studio/templates/12345/update", {
  method: "PATCH",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer <ORSHOT_API_KEY>",
  },
  body: JSON.stringify({
    name: "Summer Sale Banner - Updated"
  }),
});

Rate Limits

LimitValue
Requests per minute30

URL Parameters

ParameterTypeRequiredDescription
templateIdIntegerYesThe ID of the template to update

Request Body Parameters

At least one of the following parameters must be provided:

ParameterTypeRequiredDescription
nameStringNoNew name for the template (max 255 characters)
descriptionStringNoNew description for the template

Response Fields

FieldTypeDescription
successBooleanWhether the update was successful
templateObjectUpdated template information
template.idIntegerTemplate ID
template.nameStringUpdated template name
template.descriptionStringUpdated template description
template.updated_atStringISO 8601 timestamp of the update

Error Responses

Status CodeErrorDescription
400At least one field requiredNeither name nor description provided
400name must be non-empty stringEmpty or invalid name provided
400name must be 255 characters or lessName exceeds maximum length
400description must be a stringInvalid description type
403Access ForbiddenInvalid API key or template not in workspace
404Template not foundTemplate ID doesn't exist
429Rate limit exceededToo many requests (max 30/min)
500Internal server errorServer-side error

Cache Invalidation

When the template is updated:

  1. Template render cache is automatically invalidated
  2. Dynamic URL cache for the template is cleared

Use Cases

  • Rename templates after generation or import
  • Update descriptions for better organization
  • Batch rename templates via programmatic naming conventions
  • Add metadata to generated variant templates

All Set? Let's Start Automating

Get Your API Key →
  • Image, PDF and Video Generation via API
  • Canva like editor with AI and smart features
  • No-Code Integrations (Zapier, Make, n8n etc.)
  • Embed Orshot Studio in your app
  • Start Free. No credit card required. Cancel anytime.