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.

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