NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Placid connects to a Nagent workspace with an API key. Once it is connected, agents can call 11 Placid actions, such as "Create Collection", "Create Template" and "Get Collection". 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 Placid, with input parameters and output schema.
PLACID_CREATE_COLLECTIONTool to create a new template collection to group multiple templates. Use when organizing templates into collections with custom metadata.
Input parameters
Title of the collection (max 255 chars)
Custom data to save and forward (max 255 chars)
Array of template UUIDs to include (limited to 500)
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
PLACID_CREATE_TEMPLATETool to create a new Placid template. Use when you need a template with specific dimensions and optional tags or custom metadata. Example: "Create a social-media banner."
Input parameters
Optional URL pointing to a PSD or other template source.
Optional list of tags to organize templates.
Name of the template.
Width of the template in pixels (must be >= 10).
Height of the template in pixels (must be >= 10).
Arbitrary custom data (string or object, max 255 chars when serialized).
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
PLACID_DELETE_COLLECTIONTool to delete a template collection by its ID. Use after confirming the collection is no longer needed. Note: This does not delete the templates within the collection.
Input parameters
Unique collection ID
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
PLACID_DELETE_TEMPLATETool to delete a specific template identified by UUID. Use after confirming the template is no longer needed.
Input parameters
UUID 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
PLACID_GET_COLLECTIONTool to retrieve a single collection by its ID. Use when you need details about a specific collection including its title, custom data, and associated template UUIDs.
Input parameters
Unique collection ID (UUID format) 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
PLACID_GET_COLLECTIONSTool to retrieve a list of all template collections. Use after authentication to paginate through your Placid collections.
Input parameters
Cursor for cursor-based pagination. Use the value from the 'next' link in the response to get the next page.
Number of collections per page (1-100). Server default is 20 if not specified.
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
PLACID_GET_TEMPLATETool to retrieve a template by UUID. Returns template details including title, thumbnail, tags, and layers.
Input parameters
Unique template UUID 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
PLACID_LIST_NL_TEMPLATESTool to list all available templates via the Natural Language API. Use when you need to discover available templates for generating images.
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
PLACID_LIST_TEMPLATESTool to retrieve a list of templates from your project. Returns 20 items per page with cursor pagination. Use to browse templates, optionally filtered by collection or title.
Input parameters
Cursor for cursor-based pagination. Use the value from the 'next' link in the response to get the next page.
Sort templates. Format: <field>-<direction>. Fields: created_at, updated_at, title. Directions: asc, desc
Filter templates by title
Filter templates by collection UUID
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
PLACID_UPDATE_COLLECTIONTool to update an existing template collection. Use to modify title, custom_data, or manage templates (replace all, or incrementally add/remove specific templates).
Input parameters
New title of the collection (max 255 characters)
Custom reference data to save and forward with the collection (max 1024 characters)
Unique collection ID to update
Replace entire list of template UUIDs in the collection (limited to 500 templates). Mutually exclusive with add_template_uuids and remove_template_uuids.
List of template UUIDs to add to the collection. Cannot be used with template_uuids.
List of template UUIDs to remove from the collection. Cannot be used with template_uuids.
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
PLACID_UPDATE_TEMPLATETool to update an existing Placid template. Use when you need to modify the title, tags, or custom_data of a template.
Input parameters
Array of tags to assign to the template
Updated title of the template
Custom reference data for the template
Unique template UUID to update
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 11 Placid actions on Nagent, including "Create Collection", "Create Template" and "Get Collection". Create Collection: Create a new template collection to group multiple templates. Each action is listed on this page with its input parameters and its output.
Placid 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.
Create Collection takes 1 required input: title. It also takes 2 optional inputs: custom_data and template_uuids. It returns data, error and successful.