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...)

Discover how to create your first design on Abyssale

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 Templates

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

GEThttps://api.abyssale.com/templates

Authorization

api_key

Response

200

Ok

Body

application/json

id*string

Unique identifier (UUID) of the template.

Example: "64238d01-d402-474b-8c2d-fbc957e9d290"

name*string

Name of the template.

Example: "Ad campaign fall 2022"

created_at*integer

Timestamp of when the template has been created.

Example: 1649942114

updated_at*integer

Timestamp of when the template has been updated for the last time.

Example: 1649942114

Request

JavaScriptCurlPython

const response = await fetch('https://api.abyssale.com/templates', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  {
    "id": "64238d01-d402-474b-8c2d-fbc957e9d290",
    "name": "Ad campaign fall 2022",
    "created_at": 1649942114,
    "updated_at": 1649942114
  }
]

The full api reference can be found here

The templates can be filtered by type using a query URL property : /templates?type=animated or /templates?type=static

Sample response

[
  {
    "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.