NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Templated connects to a Nagent workspace with an API key. Once it is connected, agents can call 30 Templated actions, such as "Add Tags to Template", "Create Folder" and "Create Template Render". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Templated, with input parameters and output schema.
TEMPLATED_ADD_TAGS_TO_TEMPLATETool 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
List of tags to add to the template; existing tags are preserved
The unique identifier of the template to which tags will be added
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TEMPLATED_CLONE_TEMPLATE_ACTIONTool 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
ID of the template to clone
Name for the cloned template
Description for the cloned template
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TEMPLATED_COUNT_TEMPLATE_CLONESTool 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
The unique ID of the source template to count clones for.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TEMPLATED_CREATE_FOLDERTool to create a new folder for organizing templates and renders. Use when you need to organize templates into logical groups.
Input parameters
Name of the folder to create.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TEMPLATED_CREATE_RENDERCreate document renders from templates. Supports single/batch rendering with extensive customization. Returns a list of render objects (one per page for multi-page templates).
Input parameters
Video frames per second
CMYK color mode for PDF
Custom render name
Synchronous vs. asynchronous rendering
Merge multi-page renders into single PDF
Multi-page layer modifications
Resize factor
Custom render width in pixels
Output format
Custom render height in pixels
Layer overrides for template. Can be LayerModification objects or simple strings (treated as text).
Flatten the PDF when the render format is pdf
Video length in milliseconds
Template identifier to render
Multiple template IDs for batch rendering (overrides template)
Background color (hex format)
External identifier for tracking
PNG background transparency
Completion notification URL
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TEMPLATED_CREATE_TEMPLATETool 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
The name of the template
The width of the template in pixels (max 5000)
The height of the template in pixels (max 5000)
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
Default video duration in milliseconds for MP4 renders
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TEMPLATED_DELETE_FOLDERTool 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
Unique identifier of the folder to delete. The folder must be empty before deletion.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TEMPLATED_DELETE_RENDERTool to delete a specific render by its ID. Use when you need to permanently remove a render and its associated output files.
Input parameters
The unique identifier of the render to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TEMPLATED_DELETE_TEMPLATETool to delete a template by its unique ID. Use when you have confirmed the template ID and need to remove it permanently.
Input parameters
Unique identifier of the template to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TEMPLATED_DUPLICATE_RENDERTool 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
Unique identifier of the render to duplicate
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TEMPLATED_GET_ACCOUNT_INFORMATIONTool 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
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TEMPLATED_LIST_ALL_TEMPLATESTool to list all templates of a user. Use when you need to retrieve available templates with optional pagination.
Input parameters
Page number for pagination (0-indexed, starts at 0).
Filter templates by tags (comma-separated).
Number of templates per page (default is 25).
Search templates by name.
Filter templates by width in pixels.
Filter templates by height in pixels.
Filter templates by external ID.
Include page and layer data in the response.
Include layer data in the response.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TEMPLATED_LIST_FOLDER_RENDERSTool 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
ID of the folder to list renders for
Page number for pagination, must be >= 1
Number of renders per page, between 1 and 100
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TEMPLATED_LIST_FOLDERSTool to list all folders in the account. Use when you need to retrieve available folders that help organize templates and renders.
Input parameters
Page number for pagination (0-indexed, starts at 0).
Number of folders per page (default is 25).
Filter folders by name.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TEMPLATED_LIST_FOLDER_TEMPLATESTool to list all templates in a specific folder. Use when you need to retrieve templates contained in a folder.
Input parameters
The unique identifier of the folder to list templates from
Page number for pagination (0-indexed, starts at 0)
Number of templates per page (default is 25)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TEMPLATED_LIST_FONTSTool 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
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TEMPLATED_LIST_GALLERY_TEMPLATESTool to list templates from the public gallery. Use when you need to browse available templates that can be cloned for use.
Input parameters
Page number for pagination (0-indexed, starts at 0).
Filter templates by tags (comma-separated).
Number of templates per page (default is 25).
Filter templates by name or description.
Filter templates by exact width in pixels.
Filter templates by exact height in pixels.
Filter templates by category name.
Include template layers in response.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TEMPLATED_LIST_RENDERSTool to list all renders in the account. Use when you need to retrieve all available renders for the authenticated user.
Input parameters
Page number for pagination (0-indexed). Defaults to 0 on the API side.
Maximum number of renders to return per page. Defaults to 25 on the API side.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TEMPLATED_LIST_TEMPLATE_CLONESTool 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
Page number for pagination (0-indexed, starts at 0).
Number of templates per page (default is 25, maximum is 100).
Filter clones by their external ID. This is useful for retrieving clones associated with specific records in your system.
Filter clones by their source template ID. If not provided, returns all clone templates of the account.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TEMPLATED_LIST_TEMPLATE_RENDERSTool to list all renders of a specific template. Use after obtaining a template ID when you need paginated render results.
Input parameters
ID of the template to list renders for
Page number for pagination, must be >= 1
Number of renders per page, between 1 and 100
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TEMPLATED_LIST_UPLOADSTool 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
Page number for pagination (0-indexed, starts at 0).
Filter uploads by tags (comma-separated).
Number of uploads per page (default is 15).
Search uploads by name or tag.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TEMPLATED_MERGE_RENDERSTool 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
The render IDs of the renders that will be merged. Renders are processed in the order provided.
When true, the merged PDF uploads to servers and returns a URL. When false (default), returns binary PDF data for direct download.
Optional collection of PDF URLs to combine with renders. External PDFs are processed after renders in provided sequence.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TEMPLATED_MOVE_RENDER_TO_FOLDERTool to move a render to a specific folder. Use when you need to organize renders by moving them into folders.
Input parameters
The ID of the folder where you want to move the render.
The ID of the render you want to move.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TEMPLATED_MOVE_TEMPLATE_TO_FOLDERTool to move a template to a folder. Use when you need to organize templates by moving them into specified folders.
Input parameters
The ID of the folder where you want to move the template
The ID of the template you want to move
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TEMPLATED_REMOVE_TEMPLATE_TAGSTool to remove specific tags from a template. Use when you have a template ID and want to untag existing tags.
Input parameters
List of tag names to remove from the template
Unique identifier of the template to modify
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TEMPLATED_RETRIEVE_RENDERTool 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
Unique identifier of the render to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TEMPLATED_RETRIEVE_TEMPLATETool to retrieve a single Template by its unique ID. Use after obtaining the template ID.
Input parameters
The unique identifier of the template to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TEMPLATED_UPDATE_FOLDERTool to update an existing folder's properties. Use when you need to change a folder's name or other attributes.
Input parameters
The unique identifier of the folder to update
New name for the folder
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TEMPLATED_UPDATE_TEMPLATETool 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
The unique identifier of the template to update
Template name
Array of page objects for multi-page templates
Template width in pixels (max 5000)
Template height in pixels (max 5000)
Array of layer objects to modify or add. Use with replaceLayers query parameter to control replacement behavior.
Template description
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
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TEMPLATED_UPDATE_TEMPLATE_TAGSTool to overwrite all tags on a template. Use when you need to replace the entire tag list for a specific template.
Input parameters
List of tags to assign to the template, replacing all existing tags
The unique identifier of the template to update tags for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 30 Templated actions on Nagent, including "Add Tags to Template", "Create Folder" and "Create Template Render". Add Tags to Template: Append new tags to an existing template without overwriting existing tags. Each action is listed on this page with its input parameters and its output.
Templated connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
Add Tags to Template takes 2 required inputs: tags and template_id. It returns data, error and successful.