Designs
A design is a reusable creative blueprint that defines the visual structure and output specifications of your marketing assets. It includes at least:
- one format (dimension, e.g. Facebook feed 1200×628 or IAB 300×250)
- one element (text, button, image, shape…)
Each layer has configurable properties: colors, opacity, content, positioning, and layer-specific settings. Properties set in the design builder are the defaults — you can override any property at generation time through the API.
INFO
Only designs listed in the Projects page are accessible via API.
Design Types
| Type | Output | Use case |
|---|---|---|
| Static | PNG, JPEG, PDF | Single-frame assets: social posts, display ads |
| Animated | MP4, GIF, HTML5 ZIP | Motion content: video ads, animated banners |
| PDF (Print) | Printable PDF | Single-page print: flyers, brochures |
| Multi-page PDF (Print) | Printable PDF | Multi-page print: catalogs, presentations |
Format compatibility
| Design type | jpeg | png | gif | html5 | mp4 | printable PDF | |
|---|---|---|---|---|---|---|---|
| static | ✓ | ✓ | ✓ | ||||
| animated | ✓ | ✓ | ✓ | ||||
| printer | ✓ | ||||||
| printer_multipage | ✓ |

Get Designs
GET/designsAPI Reference
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
project_id | string (uuid) | No | Filter designs by project UUID. |
type | string | No | Filter by design type: "static", "animated", "print", "print_multipage". |
Response
Returns an array of design objects.
| Field | Type | Description |
|---|---|---|
id | string (uuid) | Unique identifier of the design. |
name | string | Name of the design. |
type | string | Design type: "static", "animated", "print", or "print_multipage". |
created_at | integer | Unix timestamp of creation. |
updated_at | integer | Unix timestamp of last update. |
category_name | string | null | Design category, if assigned. |
preview_url | string (uri) | Preview image URL for the first format. |
Response Example
json
[
{
"id": "64238d01-d402-474b-8c2d-fbc957e9d290",
"name": "Ad campaign fall 2025",
"type": "static",
"created_at": 1649942114,
"updated_at": 1649942114,
"category_name": "Fall campaigns",
"preview_url": "https://production-banners.s3-eu-west-1.amazonaws.com/templates/e0d292f2-ec21-11e9-a539-3c408bf94155/a9b3c668-7b84-4924-adf0-815dae727d32.png"
},
{
"id": "bdf9ab44-f5fd-47ad-881d-a45906901233",
"name": "Summer video ads",
"type": "animated",
"created_at": 1663767647,
"updated_at": 1663767647,
"category_name": null,
"preview_url": "https://production-banners.s3-eu-west-1.amazonaws.com/templates/f1a302g3-dd32-22f0-b640-4d519cf05266/b0c4d779-8c95-5035-beg1-926ebf838e43.png"
}
]