# Templated

Templated is a platform that automates the generation of images and PDFs through a simple API, allowing users to design templates and render them multiple times with dynamic content.

- **Category:** images & design
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 30
- **Triggers:** 0
- **Slug:** `TEMPLATED`
- **Version:** 20260227_00

## Tools

### Add Tags to Template

**Slug:** `TEMPLATED_ADD_TAGS_TO_TEMPLATE`

Tool to append new tags to an existing template without overwriting existing tags. Use when you already have the template ID and want to add additional tags.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tags` | array | Yes | List of tags to add to the template; existing tags are preserved |
| `template_id` | string | Yes | The unique identifier of the template to which tags will be added |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Clone Template

**Slug:** `TEMPLATED_CLONE_TEMPLATE_ACTION`

Tool to clone an existing template. Use after you have a template ID and want to duplicate it with a new name. Example: "Clone template tpl_123 as 'Copy of Template'".

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | ID of the template to clone |
| `name` | string | Yes | Name for the cloned template |
| `description` | string | No | Description for the cloned template |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Count Template Clones

**Slug:** `TEMPLATED_COUNT_TEMPLATE_CLONES`

Tool to get the count of cloned templates for a specific source template. Use when you need to know how many clones exist for a particular template without retrieving the full list.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sourceTemplateId` | string | Yes | The unique ID of the source template to count clones for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Folder

**Slug:** `TEMPLATED_CREATE_FOLDER`

Tool to create a new folder for organizing templates and renders. Use when you need to organize templates into logical groups.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the folder to create. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Template Render

**Slug:** `TEMPLATED_CREATE_RENDER`

Tool to create a document render from a template. Use when you need a PDF or image output with dynamic variables. Example: "Generate an invoice PDF using template 'tpl_123' with variables { ... }."

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file_name` | string | No | File name for the rendered output. |
| `variables` | object | Yes | Key-value pairs for template variables. |
| `template_id` | string | Yes | ID of the template to render. |
| `webhook_url` | string | No | Webhook URL to receive completion notification. |
| `output_format` | string ("jpg" | "png" | "webp" | "pdf") | No | Desired output file format. Supported: 'jpg', 'png', 'webp', 'pdf'. Default is 'jpg'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Template

**Slug:** `TEMPLATED_CREATE_TEMPLATE`

Tool to create a new template with specified dimensions and layers. Use when you need to programmatically define a template with background images, text overlays, or shapes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | The name of the template |
| `width` | integer | Yes | The width of the template in pixels (max 5000) |
| `height` | integer | Yes | The height of the template in pixels (max 5000) |
| `layers` | array | Yes | An array of layer objects that make up the template. Each layer must have: layer (string - name identifier), type (string - image/text/shape), and type-specific properties |
| `duration` | integer | No | Default video duration in milliseconds for MP4 renders |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Folder

**Slug:** `TEMPLATED_DELETE_FOLDER`

Tool to delete a folder by its ID. The folder must be empty before deletion. Use when you have confirmed the folder ID and need to remove it permanently.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the folder to delete. The folder must be empty before deletion. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Render

**Slug:** `TEMPLATED_DELETE_RENDER`

Tool to delete a specific render by its ID. Use when you need to permanently remove a render and its associated output files.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the render to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Template

**Slug:** `TEMPLATED_DELETE_TEMPLATE`

Tool to delete a template by its unique ID. Use when you have confirmed the template ID and need to remove it permanently.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the template to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Duplicate Template Render

**Slug:** `TEMPLATED_DUPLICATE_RENDER`

Tool to duplicate an existing render with the same settings and template. Use when you need to create a copy of a render. The duplicated render will use the same template and payload as the original.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the render to duplicate |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Account Information

**Slug:** `TEMPLATED_GET_ACCOUNT_INFORMATION`

Tool to retrieve account information, including email, name, team name, API usage statistics, and subscription plan. Use to check current API quota usage or verify API token validity.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List All Templates

**Slug:** `TEMPLATED_LIST_ALL_TEMPLATES`

Tool to list all templates of a user. Use when you need to retrieve available templates with optional pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (0-indexed, starts at 0). |
| `tags` | string | No | Filter templates by tags (comma-separated). |
| `limit` | integer | No | Number of templates per page (default is 25). |
| `query` | string | No | Search templates by name. |
| `width` | integer | No | Filter templates by width in pixels. |
| `height` | integer | No | Filter templates by height in pixels. |
| `externalId` | string | No | Filter templates by external ID. |
| `includePages` | boolean | No | Include page and layer data in the response. |
| `includeLayers` | boolean | No | Include layer data in the response. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Folder Renders

**Slug:** `TEMPLATED_LIST_FOLDER_RENDERS`

Tool to list all renders in a specific folder. Use when you need to retrieve all renders contained in a folder with optional pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | ID of the folder to list renders for |
| `page` | integer | No | Page number for pagination, must be >= 1 |
| `limit` | integer | No | Number of renders per page, between 1 and 100 |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Folders

**Slug:** `TEMPLATED_LIST_FOLDERS`

Tool to list all folders in the account. Use when you need to retrieve available folders that help organize templates and renders.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (0-indexed, starts at 0). |
| `limit` | integer | No | Number of folders per page (default is 25). |
| `query` | string | No | Filter folders by name. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Folder Templates

**Slug:** `TEMPLATED_LIST_FOLDER_TEMPLATES`

Tool to list all templates in a specific folder. Use when you need to retrieve templates contained in a folder.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the folder to list templates from |
| `page` | integer | No | Page number for pagination (0-indexed, starts at 0) |
| `limit` | integer | No | Number of templates per page (default is 25) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Fonts

**Slug:** `TEMPLATED_LIST_FONTS`

Tool to list all available fonts including Google Fonts and user-uploaded custom fonts. Use when you need to retrieve the names and metadata of fonts available in the account.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Gallery Templates

**Slug:** `TEMPLATED_LIST_GALLERY_TEMPLATES`

Tool to list templates from the public gallery. Use when you need to browse available templates that can be cloned for use.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (0-indexed, starts at 0). |
| `tags` | string | No | Filter templates by tags (comma-separated). |
| `limit` | integer | No | Number of templates per page (default is 25). |
| `query` | string | No | Filter templates by name or description. |
| `width` | integer | No | Filter templates by exact width in pixels. |
| `height` | integer | No | Filter templates by exact height in pixels. |
| `category` | string | No | Filter templates by category name. |
| `includeLayers` | boolean | No | Include template layers in response. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List All Renders

**Slug:** `TEMPLATED_LIST_RENDERS`

Tool to list all renders in the account. Use when you need to retrieve all available renders for the authenticated user.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Template Clones

**Slug:** `TEMPLATED_LIST_TEMPLATE_CLONES`

Tool to list all cloned templates in the account. Use when you need to retrieve templates that were cloned from the gallery or other sources, with optional filtering by source template ID or external ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (0-indexed, starts at 0). |
| `limit` | integer | No | Number of templates per page (default is 25, maximum is 100). |
| `externalId` | string | No | Filter clones by their external ID. This is useful for retrieving clones associated with specific records in your system. |
| `sourceTemplateId` | string | No | Filter clones by their source template ID. If not provided, returns all clone templates of the account. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Template Renders

**Slug:** `TEMPLATED_LIST_TEMPLATE_RENDERS`

Tool to list all renders of a specific template. Use after obtaining a template ID when you need paginated render results.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | ID of the template to list renders for |
| `page` | integer | No | Page number for pagination, must be >= 1 |
| `page_size` | integer | No | Number of renders per page, between 1 and 100 |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Uploads

**Slug:** `TEMPLATED_LIST_UPLOADS`

Tool to list all uploaded images in the account. Returns upload details including URLs and metadata. Use when you need to retrieve available uploads with optional pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (0-indexed, starts at 0). |
| `tags` | string | No | Filter uploads by tags (comma-separated). |
| `limit` | integer | No | Number of uploads per page (default is 15). |
| `query` | string | No | Search uploads by name or tag. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Merge Template Renders

**Slug:** `TEMPLATED_MERGE_RENDERS`

Tool to merge multiple renders into a single PDF output. Use when combining multiple images or pages into a unified document. When host=true, returns a URL to the hosted file. When host=false, returns the PDF binary for immediate download.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ids` | array | Yes | The render IDs of the renders that will be merged. Renders are processed in the order provided. |
| `host` | boolean | No | When true, the merged PDF uploads to servers and returns a URL. When false (default), returns binary PDF data for direct download. |
| `urls` | array | No | Optional collection of PDF URLs to combine with renders. External PDFs are processed after renders in provided sequence. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Move Render to Folder

**Slug:** `TEMPLATED_MOVE_RENDER_TO_FOLDER`

Tool to move a render to a specific folder. Use when you need to organize renders by moving them into folders.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `folder_id` | string | Yes | The ID of the folder where you want to move the render. |
| `render_id` | string | Yes | The ID of the render you want to move. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Move Template to Folder

**Slug:** `TEMPLATED_MOVE_TEMPLATE_TO_FOLDER`

Tool to move a template to a folder. Use when you need to organize templates by moving them into specified folders.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `folderId` | string | Yes | The ID of the folder where you want to move the template |
| `templateId` | string | Yes | The ID of the template you want to move |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Remove Template Tags

**Slug:** `TEMPLATED_REMOVE_TEMPLATE_TAGS`

Tool to remove specific tags from a template. Use when you have a template ID and want to untag existing tags.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tags` | array | Yes | List of tag names to remove from the template |
| `template_id` | string | Yes | Unique identifier of the template to modify |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Retrieve Template Render

**Slug:** `TEMPLATED_RETRIEVE_RENDER`

Tool to retrieve details of a specific render by its ID. Use after obtaining the render ID when you need details of a render.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the render to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Retrieve Template

**Slug:** `TEMPLATED_RETRIEVE_TEMPLATE`

Tool to retrieve a single Template by its unique ID. Use after obtaining the template ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the template to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Folder

**Slug:** `TEMPLATED_UPDATE_FOLDER`

Tool to update an existing folder's properties. Use when you need to change a folder's name or other attributes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the folder to update |
| `name` | string | No | New name for the folder |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Template

**Slug:** `TEMPLATED_UPDATE_TEMPLATE`

Tool to update an existing template including its properties and layers. Use replaceLayers=true to replace all layers (layers not in array will be removed), or false/omit to update existing layers and add new ones.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the template to update |
| `name` | string | No | Template name |
| `pages` | array | No | Array of page objects for multi-page templates |
| `width` | integer | No | Template width in pixels (max 5000) |
| `height` | integer | No | Template height in pixels (max 5000) |
| `layers` | array | No | Array of layer objects to modify or add. Use with replaceLayers query parameter to control replacement behavior. |
| `description` | string | No | Template description |
| `replaceLayers` | boolean | No | If true, replaces all layers; layers not in the array will be removed. If false or omitted, updates existing layers and adds new ones. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Template Tags

**Slug:** `TEMPLATED_UPDATE_TEMPLATE_TAGS`

Tool to overwrite all tags on a template. Use when you need to replace the entire tag list for a specific template.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tags` | array | Yes | List of tags to assign to the template, replacing all existing tags |
| `template_id` | string | Yes | The unique identifier of the template to update tags for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |