# Placid

Placid is a creative automation toolkit that enables users to generate images, PDFs, and videos from custom templates via REST or URL APIs.

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

## Tools

### Create Collection

**Slug:** `PLACID_CREATE_COLLECTION`

Tool to create a new template collection to group multiple templates. Use when organizing templates into collections with custom metadata.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `title` | string | Yes | Title of the collection (max 255 chars) |
| `custom_data` | string | No | Custom data to save and forward (max 255 chars) |
| `template_uuids` | array | No | Array of template UUIDs to include (limited to 500) |

#### 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:** `PLACID_CREATE_TEMPLATE`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | No | Optional URL pointing to a PSD or other template source. |
| `tags` | array | No | Optional list of tags to organize templates. |
| `title` | string | Yes | Name of the template. |
| `width` | integer | Yes | Width of the template in pixels (must be >= 10). |
| `height` | integer | Yes | Height of the template in pixels (must be >= 10). |
| `custom_data` | string | No | Arbitrary custom data (string or object, max 255 chars when serialized). |

#### 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 Collection

**Slug:** `PLACID_DELETE_COLLECTION`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `collection_id` | string | Yes | Unique collection ID |

#### 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:** `PLACID_DELETE_TEMPLATE`

Tool to delete a specific template identified by UUID. Use after confirming the template is no longer needed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `template_uuid` | string | Yes | UUID 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 |

### Get Collection

**Slug:** `PLACID_GET_COLLECTION`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `collection_id` | string | Yes | Unique collection ID (UUID format) 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 |

### Get Collections

**Slug:** `PLACID_GET_COLLECTIONS`

Tool to retrieve a list of all template collections. Use after authentication to paginate through your Placid collections.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Cursor for cursor-based pagination. Use the value from the 'next' link in the response to get the next page. |
| `per_page` | integer | No | Number of collections per page (1-100). Server default is 20 if not specified. |

#### 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 Template

**Slug:** `PLACID_GET_TEMPLATE`

Tool to retrieve a template by UUID. Returns template details including title, thumbnail, tags, and layers.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `template_uuid` | string | Yes | Unique template UUID 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 |

### List NL Templates

**Slug:** `PLACID_LIST_NL_TEMPLATES`

Tool to list all available templates via the Natural Language API. Use when you need to discover available templates for generating images.

#### 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 Templates

**Slug:** `PLACID_LIST_TEMPLATES`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Cursor for cursor-based pagination. Use the value from the 'next' link in the response to get the next page. |
| `order_by` | string | No | Sort templates. Format: <field>-<direction>. Fields: created_at, updated_at, title. Directions: asc, desc |
| `title_filter` | string | No | Filter templates by title |
| `collection_id` | string | No | Filter templates by collection UUID |

#### 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 Collection

**Slug:** `PLACID_UPDATE_COLLECTION`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `title` | string | No | New title of the collection (max 255 characters) |
| `custom_data` | string | No | Custom reference data to save and forward with the collection (max 1024 characters) |
| `collection_id` | string | Yes | Unique collection ID to update |
| `template_uuids` | array | No | Replace entire list of template UUIDs in the collection (limited to 500 templates). Mutually exclusive with add_template_uuids and remove_template_uuids. |
| `add_template_uuids` | array | No | List of template UUIDs to add to the collection. Cannot be used with template_uuids. |
| `remove_template_uuids` | array | No | List of template UUIDs to remove from the collection. Cannot be used with template_uuids. |

#### 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:** `PLACID_UPDATE_TEMPLATE`

Tool to update an existing Placid template. Use when you need to modify the title, tags, or custom_data of a template.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tags` | array | No | Array of tags to assign to the template |
| `title` | string | No | Updated title of the template |
| `custom_data` | string | No | Custom reference data for the template |
| `template_uuid` | string | Yes | Unique template UUID to update |

#### 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 |