Designs

List all your designs - Abyssale REST API

A design is a reusable creative blueprint that defines both the visual structure and output specifications of your marketing assets. It includes at least:

  • one format (dimension, i.e. Facebook feed 1200x628 or IAB 300x250)

  • one element (text, button, image, shape...)

Each layer in a design has configurable properties that control its appearance and behavior. These properties can include:

  • Visual attributes (colors, opacity, effects)

  • Content values (text content, image sources)

  • Positioning and layout settings

  • Layer-specific configurations

Element properties

The properties you set in the design builder serve as default values. However, you can dynamically override any property at generation time through the API, enabling:

  • Dynamic styling changes

  • Contextual customization

  • A/B testing variations

Design Types

Our platform supports four distinct design types, each optimized for different output needs:

Static Design

  • Purpose: Creates static visual assets

  • Output formats: PNG, JPEG, PDF

  • Use case: Single-frame marketing assets like social posts or display ads

Animated Design

  • Purpose: Creates dynamic visual content with motion

  • Features:

    • Animation effects (fade, slide, transitions)

    • Optional background video support

  • Output formats:

    • MP4 video

    • Animated GIF

    • HTML5 banner (ZIP package)

PDF Design

  • Purpose: Creates print-ready single-page documents

  • Output format: PDF

  • Use case: Brochures, flyers, or print advertisements

Multi-page PDF Design

  • Purpose: Creates multi-page documents

  • Output format: PDF

  • Use case: Catalogs, presentations, or multi-page marketing materials

Here is the mapping between a template type and supported generation file types:

Template type
jpeg
png
pdf
gif
html5
mp4
printable PDF

static

animated

printer

printer_multipage

Get your designs

Abyssale provides a list of free templates in the Templates library page. Feel free to use one to start designing a template instead of doing it from scratch.

Only designs listed in the Projects page are accessible via API.

Get Designs

get

Retrieve all of your designs (containing for each the id, name, creation date & update date)

Authorizations
Path parameters
category_idstring · uuidOptional

Unique identifier (UUID) of a category. Filter designs by a category.

typestring · enumOptional

Filter designs by one of these types static, animated, printer, printer_multipage

Possible values:
Responses
200
Ok
application/json
get
GET /designs HTTP/1.1
Host: api.abyssale.com
x-api-key: YOUR_API_KEY
Accept: */*
200

Ok

[
  {
    "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": "3f1900f0-9a0f-4d3f-867e-1bb3a6e4fa2d",
    "name": "Abyssale demo - FB Square",
    "type": "static",
    "created_at": 1681215684,
    "updated_at": 1681217794,
    "preview_url": "https://production-banners.s3-eu-west-1.amazonaws.com/templates/e0d292f2-ec21-11e9-a539-3c408bf94155/65422510-332e-4da6-ab50-d40ff532d000.png",
    "category_name": "Abyssale Demo"
  },
  {
    "id": "46d22c62-d134-44d3-a040-138e4ea9ea08",
    "name": "Abyssale demo - FB Feed",
    "type": "static",
    "created_at": 1688631025,
    "updated_at": 1688977170,
    "preview_url": "https://production-banners.s3-eu-west-1.amazonaws.com/templates/e0d292f2-ec21-11e9-a539-3c408bf94155/9c872731-da6f-4923-b342-7c4250ac94cc.png",
    "category_name": "Abyssale Demo"
  }
]

This sample contains 2 designs:

  • Abyssale demo - FB Feed (static template) with the 46d22c62-d134-44d3-a040-138e4ea9ea08 template ID

  • Abyssale demo - FB Square (static template) with the 3f1900f0-9a0f-4d3f-867e-1bb3a6e4fa2d template ID

The preview_url property is the image associated with the first format in the template.

Last updated