---
canonical_url: "https://docs.composio.dev/toolkits/dynamic_mockups"
markdown_url: "https://docs.composio.dev/toolkits/dynamic_mockups.md"
product: "platform"
version: null
last_updated: null
---

# Dynamic Mockups

Dynamic Mockups provides APIs for generating product mockups, rendering templates, managing catalogs and collections, and creating AI-powered image and motion assets.

- **Category:** images & design
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 10
- **Triggers:** 0
- **Slug:** `DYNAMIC_MOCKUPS`
- **Version:** 00000000_00

## Tools

### Create MockAnything Mockup

**Slug:** `DYNAMIC_MOCKUPS_CREATE_MOCKANYTHING_MOCKUP`

Create and optionally wait for a MockAnything mockup from exactly one prompt, public image URL, or uploaded image. WARNING: this persists a mockup, may find-or-create named collections, and consumes model-dependent credits on SUCCESS; the connected account's tier and balance are unknown. Polling is bounded and may return completed=false with a task_id for later status checks.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Optional saved mockup name, at most 255 characters. |
| `model` | string | No | Optional current prompt-generation model identifier. Consult Get Generation Options and omit this field to use the provider default. |
| `style` | string | No | Optional style ID from Get Generation Options. This requires both prompt and model. |
| `prompt` | string | No | Text prompt for AI generation. Provide exactly one of prompt, image_url, or image_file. |
| `product` | object | No | Optional POD product context used to ground a prompt-based generation. |
| `image_url` | string | No | Public HTTP(S) URL of a JPG, JPEG, PNG, GIF, or WebP image. Provide exactly one source. |
| `image_file` | object | No | Uploaded JPG, JPEG, PNG, GIF, or WebP image, no larger than 10 MB. Provide exactly one source. |
| `collections` | array | No | Collections to attach. Each item must contain exactly one existing uuid or find-or-create name. |
| `aspect_ratio` | string | No | Optional ratio from Get Generation Options for prompt generation. The official provider MCP sends this field, but live create acceptance has not been verified. |
| `catalog_uuid` | string | No | Optional catalog UUID in which to save the mockup. |
| `enhance_prompt` | boolean | No | Whether the provider should enhance the prompt before generation. |
| `wait_timeout_seconds` | integer | No | Maximum seconds to wait while checking status every 2 seconds (0-300). Use 0 to return the submitted task immediately. |

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

**Slug:** `DYNAMIC_MOCKUPS_GET_GENERATION_OPTIONS`

Return current MockAnything styles and aspect-ratio support plus MotionMockups models, durations, aspect ratios, estimated times, and live credit prices. Call this before choosing generation settings because model availability and costs change.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mockanything_model` | string | No | Optional current MockAnything model identifier used to filter styles. Omit it to return styles for all models. |

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

**Slug:** `DYNAMIC_MOCKUPS_GET_MOCKANYTHING_PRODUCT`

Get one POD product's supported sizes, colors, and decoration locations before using its UUID in MockAnything generation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `product_uuid` | string | Yes | Product UUID returned by Search MockAnything Products and used to fetch the product's generation metadata. |

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

**Slug:** `DYNAMIC_MOCKUPS_GET_MOCKANYTHING_STATUS`

Check one MockAnything task once, typically after Create MockAnything Mockup stops waiting. WARNING: a well-formed unknown UUID may return PENDING indefinitely, so PENDING does not prove the task exists and this tool never loops.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `task_id` | string | Yes | Task UUID returned by Create MockAnything Mockup. Do not use a guessed UUID because unknown UUIDs may remain PENDING indefinitely. |

#### 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 Motion Mockup Status

**Slug:** `DYNAMIC_MOCKUPS_GET_MOTION_MOCKUP_STATUS`

Check a submitted MotionMockups video job once and return its queue state or completed MP4 metadata. The tool does not poll automatically because jobs commonly take 2-15 minutes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `request_id` | string | Yes | Request ID returned by Submit Motion Mockup. |

#### 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 Catalogs and Collections

**Slug:** `DYNAMIC_MOCKUPS_LIST_CATALOGS_AND_COLLECTIONS`

Return the connected account's catalogs and collections, including the UUIDs used to filter mockups and target creation or bulk workflows. This is read-only and does not consume render credits.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `catalog_uuid` | string | No | Optional catalog UUID used to filter collections; omit it to use the provider's default catalog. |
| `include_all_catalogs` | boolean | No | Whether to include collections across all accessible catalogs. |

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

**Slug:** `DYNAMIC_MOCKUPS_LIST_MOCKUPS`

Find renderable mockup templates and return their mockup, smart-object, text-layer, and print-area-preset UUIDs. Filters are optional; name matching semantics are not guaranteed because they could not be verified on the empty connected account.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Optional provider-side mockup name filter. Exact versus partial matching has not been verified. |
| `catalog_uuid` | string | No | Only return mockups in this catalog UUID. Invalid UUIDs currently produce a validation error. |
| `collection_uuid` | string | No | Only return mockups in this collection UUID. Invalid UUIDs currently produce a validation error. |
| `include_all_catalogs` | boolean | No | Whether to search all accessible catalogs rather than the default catalog. |

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

### Render Mockups

**Slug:** `DYNAMIC_MOCKUPS_RENDER_MOCKUPS`

Render one or more explicitly selected mockup templates from public artwork URLs, colors, Beta text layers, and shared export settings. One item uses POST /renders and multiple items use POST /renders/batch. WARNING: every successful output consumes a credit, Free-plan API renders may be watermarked, and output URLs last about 24 hours. Account tier, credit balance, and batch limits are unknown.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `renders` | array | Yes | One or more render specifications. One item uses POST /renders; multiple items use POST /renders/batch. Every item needs a non-empty smart_objects list. |
| `export_options` | object | No | Shared output settings applied to the single render or every batch item. |

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

### Search MockAnything Products

**Slug:** `DYNAMIC_MOCKUPS_SEARCH_MOCKANYTHING_PRODUCTS`

Fuzzy-search POD products that can ground MockAnything generation. The provider may return up to 50 broad matches and exposes no pagination, so use a specific brand, style code, or product phrase.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | Yes | Non-empty fuzzy search text, preferably a brand, style code, or specific product 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 |

### Submit Motion Mockup

**Slug:** `DYNAMIC_MOCKUPS_SUBMIT_MOTION_MOCKUP`

WARNING: Submit image-to-video generation and return a request ID for later status checks. This creates a long-running job and reserves or consumes model-, duration-, and audio-dependent credits; current live-discovered prices range from 40 to 585 credits, while the connected account's tier and balance are unknown. Call Get Generation Options first. The submit endpoint is limited to 10 requests per minute.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `model` | string | No | MotionMockups model identifier. Omit to use the provider default. Call Get Generation Options first because supported settings and costs depend on the model. |
| `prompt` | string | No | Optional desired-motion prompt, at most 2500 characters. When omitted, the provider normally generates a prompt from the image. |
| `duration` | integer | No | Video duration in seconds. Valid values and credit cost depend on the selected model; use a value returned by Get Generation Options. Omit to use the model default. |
| `aspect_ratio` | string | No | Optional aspect ratio returned for the selected model by Get Generation Options. Omit for models that do not support explicit ratio selection. |
| `generate_audio` | boolean | No | Whether to generate audio. Enabling audio materially increases the model- and duration-dependent credit cost. |
| `skip_discovery` | boolean | No | When true and prompt is omitted, skip image auto-prompting and use the provider's neutral default prompt. |
| `negative_prompt` | string | No | Optional content or motion to avoid, at most 1000 characters. |
| `start_image_url` | string | Yes | Publicly reachable source-image URL to animate, at most 2000 characters. Clear, well-lit product images are recommended. |

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