API & Integration -> API Reference

Update a template

This endpoint updates an existing template in your project. You can change its name, its tags, its RenderScript source, or any combination of these.

It performs a partial update: only the fields you include in the request are changed, and any fields you leave out keep their current values. You must provide at least one of name, tags, or source.

Parameters

name string optional

A new name for the template. Can be any non-empty string.

source object optional

A new RenderScript object that replaces the template's current source.

tags array optional

A new list of text labels that replaces the template's current tags.

API endpoint

Send a PATCH request to the following endpoint using your project's API key. The template ID is passed as a parameter. This example renames a template and replaces its tags, leaving the source unchanged:

curl -X PATCH https://api.creatomate.com/v2/templates/TEMPLATE_ID \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY_HERE" \
     -d '{
       "name": "Renamed Template",
       "tags": ["Archived"]
     }'

Response

On success, the endpoint responds with 200 OK and returns the updated template, with its updated_at timestamp refreshed.

When the request includes a source, it is checked like a new template: a value the engine would reject answers 400 Bad Request with a hint listing the first problems, and nothing changes; parts the engine would ignore, such as a misspelled property name, are saved and reported in a warnings array on the response.

{
  "id": "087d94b5-cef6-44b7-96d4-4c651beec61d",
  "name": "Renamed Template",
  "tags": ["Archived"],
  "created_at": "2026-01-01T10:00:00.000Z",
  "updated_at": "2026-01-02T07:30:00.000Z",
  "source": { … }
}
If no template with the specified ID exists in your project, the API responds with 404 Not Found.