Orshot Logo
OrshotDocs

GET: Get Studio Template

Retrieve a specific studio template by ID

Retrieve a specific studio template by its ID, including all available modifications and template metadata.

Endpoint

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

URL Parameters

ParameterTypeRequiredDescription
templateIdIntegerYesThe unique ID of the template to fetch

Request

await fetch("https://api.orshot.com/v1/studio/templates/123", {
  method: "GET",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer <ORSHOT_API_KEY>",
  },
});

Response Fields

FieldTypeDescription
idIntegerUnique identifier for the template
created_atStringTimestamp when the template was created
workspace_idStringID of the workspace the template belongs to
user_idStringID of the user who created the template
canvas_widthNumberWidth of the template canvas in pixels
canvas_heightNumberHeight of the template canvas in pixels
updated_atStringTimestamp when the template was last updated
nameStringName of the template
descriptionStringDescription of the template
thumbnail_urlStringURL to the template's thumbnail image
modificationsArrayArray of available modifications for parameters
modifications_jsonObjectJSON object of modifications metadata
pages_dataArrayArray of pages (for multi-page templates)

Modification Fields

Each modification object contains:

FieldTypeDescription
keyStringUnique key for the modification
idStringID of the modification
typeStringType of modification (text, image)
helpTextStringDescription of what the field is for
exampleStringExample value for the field

Error Responses

CodeDescription
400Missing templateId parameter
403Missing or invalid API key
403Studio template not found in workspace

On this page