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

[
  {
    "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"
  }
]