---
title: "Page Theme Templates API Reference | Linkbreakers"
description: "Reusable page looks: save a link's theme as a template, publish it, import a public one, and apply it to links."
canonical: "https://linkbreakers.com/help/api/page-theme-templates"
---

# Page Theme Templates

Reusable page looks: save a link's theme as a template, publish it, import a public one, and apply it to links.

11 entries on this page

## The page theme template object

Reusable page styling presets that help teams give every link page a consistent look.

`badgeSignedUrl` string

Signed URL for the template's badge image. Empty when the template has no badge.

`builtIn` boolean

Whether the template is maintained by Linkbreakers (available to every workspace)

`coverSignedUrl` string

Signed URL for the template's cover image. Empty when the template has no cover.

`createdAt` string (date-time)

When the template was created

`description` string

Short marketing description displayed in the template picker

`duplicatedFrom` string

Reference to the original public template when this template was created via import. Null for original templates.

`faq` string

FAQ data stored as JSON.

Frequently Asked Questions about this template stored as JSON

`footerLogoSignedUrl` string

Signed URL for the template's footer logo image. Empty when the template has no footer logo.

`id` string

Unique identifier of the template (UUID)

`learnMore` string

Extended markdown-supported content providing detailed information about the template

`name` string

Human-readable name shown in the gallery

`owned` boolean

True when the template belongs to the caller's workspace. False for built-in templates and for community templates published by other workspaces.

`pageTheme` object

Page theme configuration

20 child attributes

`badgeEnabled` boolean

\--- Badge Section --- Whether badge is enabled

`badgeIconColor` object

Badge icon background color (used when badge is not selected)

4 child attributes

`colors` array of string 

Required

Color values in render order (hex, rgb/rgba, hsl/hsla).

`direction` string

Optional direction for linear gradients (e.g. "135deg", "to right").

`stops` array of string

Optional stop offsets aligned with `colors` (e.g. "0%", "50%", "100%").

`type` enum 

Required

Color type

Allowed values

* `THEME_COLOR_TYPE_SOLID`
* `THEME_COLOR_TYPE_LINEAR`
* `THEME_COLOR_TYPE_RADIAL`

`badgeId` string

Badge image ID (references media table)

`badgeShape` enum

Shape the badge image is cropped to (circle, square or rounded)

Allowed values

* `PAGE_THEME_BADGE_SHAPE_CIRCLE`
* `PAGE_THEME_BADGE_SHAPE_SQUARE`
* `PAGE_THEME_BADGE_SHAPE_ROUNDED`

`bodyFont` object

Body font configuration

6 child attributes

`bold` boolean

Bold styling

`color` object

Text color (ThemeColor)

4 child attributes

`colors` array of string 

Required

Color values in render order (hex, rgb/rgba, hsl/hsla).

`direction` string

Optional direction for linear gradients (e.g. "135deg", "to right").

`stops` array of string

Optional stop offsets aligned with `colors` (e.g. "0%", "50%", "100%").

`type` enum 

Required

Color type

Allowed values

* `THEME_COLOR_TYPE_SOLID`
* `THEME_COLOR_TYPE_LINEAR`
* `THEME_COLOR_TYPE_RADIAL`

`family` enum

Font family (strict enum mapped to native font stacks).

The enum names the seven families the editor offers. Themes can carry a stack outside that set, which has no enum value and reads back as DEFAULT, so familyStack carries the exact one and is what a client should write back when it did not change the font.

Allowed values

* `PAGE_THEME_FONT_FAMILY_DEFAULT`
* `PAGE_THEME_FONT_FAMILY_ARIAL`
* `PAGE_THEME_FONT_FAMILY_HELVETICA`
* `PAGE_THEME_FONT_FAMILY_VERDANA`
* `PAGE_THEME_FONT_FAMILY_GEORGIA`
* `PAGE_THEME_FONT_FAMILY_TIMES_NEW_ROMAN`
* `PAGE_THEME_FONT_FAMILY_COURIER_NEW`
* `PAGE_THEME_FONT_FAMILY_UNSPECIFIED` Maps to the default system sans-serif stack.

`familyStack` string

Exact CSS font stack. Takes precedence over family when writing.

`fontSize` integer (int32)

Font size in pixels

`italic` boolean

Italic styling

`canvasColor` object

\--- Background Section --- Canvas color configuration

4 child attributes

`colors` array of string 

Required

Color values in render order (hex, rgb/rgba, hsl/hsla).

`direction` string

Optional direction for linear gradients (e.g. "135deg", "to right").

`stops` array of string

Optional stop offsets aligned with `colors` (e.g. "0%", "50%", "100%").

`type` enum 

Required

Color type

Allowed values

* `THEME_COLOR_TYPE_SOLID`
* `THEME_COLOR_TYPE_LINEAR`
* `THEME_COLOR_TYPE_RADIAL`

`canvasCoverId` string

Optional cover media ID (references media table)

`canvasCoverMode` enum

Cover display mode

Allowed values

* `PAGE_THEME_BACKGROUND_COVER_MODE_FULL`
* `PAGE_THEME_BACKGROUND_COVER_MODE_PROGRESSIVE_TOP`
* `PAGE_THEME_BACKGROUND_COVER_MODE_PROGRESSIVE_BOTTOM`

`containerConfig` object

Container styling configuration

6 child attributes

`backgroundColor` object

Color filling the container behind its content, solid or gradient

4 child attributes

`colors` array of string 

Required

Color values in render order (hex, rgb/rgba, hsl/hsla).

`direction` string

Optional direction for linear gradients (e.g. "135deg", "to right").

`stops` array of string

Optional stop offsets aligned with `colors` (e.g. "0%", "50%", "100%").

`type` enum 

Required

Color type

Allowed values

* `THEME_COLOR_TYPE_SOLID`
* `THEME_COLOR_TYPE_LINEAR`
* `THEME_COLOR_TYPE_RADIAL`

`borderColor` object

Color of the container border, solid or gradient

4 child attributes

`colors` array of string 

Required

Color values in render order (hex, rgb/rgba, hsl/hsla).

`direction` string

Optional direction for linear gradients (e.g. "135deg", "to right").

`stops` array of string

Optional stop offsets aligned with `colors` (e.g. "0%", "50%", "100%").

`type` enum 

Required

Color type

Allowed values

* `THEME_COLOR_TYPE_SOLID`
* `THEME_COLOR_TYPE_LINEAR`
* `THEME_COLOR_TYPE_RADIAL`

`borderSize` integer (int32)

Border size in pixels (0 or more)

`borderStyle` enum

Line style of the container border (solid, dashed, dotted...)

Allowed values

* `PAGE_THEME_BORDER_STYLE_SOLID`
* `PAGE_THEME_BORDER_STYLE_DASHED`
* `PAGE_THEME_BORDER_STYLE_DOTTED`
* `PAGE_THEME_BORDER_STYLE_DOUBLE`
* `PAGE_THEME_BORDER_STYLE_GROOVE`
* `PAGE_THEME_BORDER_STYLE_RIDGE`

`opacity` integer (int32)

Opacity (0-100%)

`variant` enum

Container variant (required when containerConfig is set)

Allowed values

* `PAGE_THEME_CONTAINER_VARIANT_ROUNDED`
* `PAGE_THEME_CONTAINER_VARIANT_SQUARE`

`containerEnabled` boolean

Whether container is enabled

`createdAt` string (date-time) 

Read-only

When the page theme was created

`elementColor` object

Interactive element background color configuration

4 child attributes

`colors` array of string 

Required

Color values in render order (hex, rgb/rgba, hsl/hsla).

`direction` string

Optional direction for linear gradients (e.g. "135deg", "to right").

`stops` array of string

Optional stop offsets aligned with `colors` (e.g. "0%", "50%", "100%").

`type` enum 

Required

Color type

Allowed values

* `THEME_COLOR_TYPE_SOLID`
* `THEME_COLOR_TYPE_LINEAR`
* `THEME_COLOR_TYPE_RADIAL`

`elementFont` object

Interactive element text font configuration

6 child attributes, the same as [pageTheme.bodyFont in the page theme template object](#page-theme-templates-object-pagetheme-bodyfont).

`footerLogoEnabled` boolean

Whether the footer logo (a small company or brand logo centered at the bottom of every page using this theme) is shown.

Turning it off keeps footerLogoId, so turning it back on restores the same image.

`footerLogoId` string

Footer logo image ID (a media library image)

`id` string 

Read-only

Page theme ID

`titleFont` object

\--- Typography Section --- Title font configuration

6 child attributes, the same as [pageTheme.bodyFont in the page theme template object](#page-theme-templates-object-pagetheme-bodyfont).

`updatedAt` string (date-time) 

Read-only

When the page theme was last updated

`visitorExperience` enum

How visitor pages pace their content. Unset reads as CLASSIC.

Allowed values

* `PAGE_THEME_VISITOR_EXPERIENCE_CLASSIC`
* `PAGE_THEME_VISITOR_EXPERIENCE_FOCUSED`

`workspaceId` string 

Read-only

Workspace ID this page theme belongs to

`pageThemeId` string

Backing page theme that carries the styling (UUID)

`publishedAt` string (date-time)

When the template was published. Null means private template, only visible to creating workspace.

`slug` string

Slug used in public template selection URLs

`tags` string

Tags for categorizing and filtering templates (comma-separated)

`thumbnailPendingUpdateSince` string (date-time)

When the template thumbnail entered the regeneration queue

`thumbnailSignedUrl` string

Signed thumbnail preview of the template styling

`updatedAt` string (date-time)

When the template metadata was last updated

`usageCount` integer (int64)

Number of links in the caller's workspace whose theme was applied from this template. Drives the 'most used' ordering in the template picker.

`workspaceId` string

Workspace that owns the template; empty for built-in templates (UUID when present)

Example page theme template

```json
{
  "badgeSignedUrl": "https://cdn.linkbreakers.com/media/5f1c2d3e/lumiere-badge.png?Expires=1774108800&Signature=b7Xk2pQz9LmN4vR8",
  "builtIn": false,
  "coverSignedUrl": "https://cdn.linkbreakers.com/media/5f1c2d3e/menu-cover.png?Expires=1774108800&Signature=b7Xk2pQz9LmN4vR8",
  "createdAt": "2026-03-14T09:30:00Z",
  "description": "A warm cream page with navy buttons, made for restaurant menus.",
  "duplicatedFrom": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
  "faq": "[{\"id\": \"1\", \"question\": \"Does it work on a phone?\", \"answer\": \"Yes, every page using this template is built for small screens first.\", \"order\": 1}]",
  "footerLogoSignedUrl": "https://cdn.linkbreakers.com/media/5f1c2d3e/lumiere-logo.png?Expires=1774108800&Signature=b7Xk2pQz9LmN4vR8",
  "id": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
  "learnMore": "## Spring menu\n\nWarm cream background, navy buttons and the Inter font, made for restaurant table cards.",
  "name": "Lumiere Spring",
  "owned": true,
  "pageTheme": {
    "badgeEnabled": true,
    "badgeIconColor": {
      "colors": [
        "#1F3A5F",
        "#F4EDE4"
      ],
      "direction": "135deg",
      "stops": [
        "0%",
        "100%"
      ],
      "type": "THEME_COLOR_TYPE_LINEAR"
    },
    "badgeId": "8e4a1c7d-2b9f-4d3e-a5c6-9f0b1e7d3a52",
    "badgeShape": "PAGE_THEME_BADGE_SHAPE_CIRCLE",
    "bodyFont": {
      "bold": true,
      "color": {
        "colors": [
          "#1F3A5F",
          "#F4EDE4"
        ],
        "direction": "135deg",
        "stops": [
          "0%",
          "100%"
        ],
        "type": "THEME_COLOR_TYPE_LINEAR"
      },
      "family": "PAGE_THEME_FONT_FAMILY_GEORGIA",
      "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
      "fontSize": 18,
      "italic": false
    },
    "canvasColor": {
      "colors": [
        "#1F3A5F",
        "#F4EDE4"
      ],
      "direction": "135deg",
      "stops": [
        "0%",
        "100%"
      ],
      "type": "THEME_COLOR_TYPE_LINEAR"
    },
    "canvasCoverId": "5f1c2d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f",
    "canvasCoverMode": "PAGE_THEME_BACKGROUND_COVER_MODE_PROGRESSIVE_TOP",
    "containerConfig": {
      "backgroundColor": {
        "colors": [
          "#1F3A5F",
          "#F4EDE4"
        ],
        "direction": "135deg",
        "stops": [
          "0%",
          "100%"
        ],
        "type": "THEME_COLOR_TYPE_LINEAR"
      },
      "borderColor": {
        "colors": [
          "#1F3A5F",
          "#F4EDE4"
        ],
        "direction": "135deg",
        "stops": [
          "0%",
          "100%"
        ],
        "type": "THEME_COLOR_TYPE_LINEAR"
      },
      "borderSize": 2,
      "borderStyle": "PAGE_THEME_BORDER_STYLE_SOLID",
      "opacity": 90,
      "variant": "PAGE_THEME_CONTAINER_VARIANT_ROUNDED"
    },
    "containerEnabled": true,
    "createdAt": "2026-03-14T09:30:00Z",
    "elementColor": {
      "colors": [
        "#1F3A5F",
        "#F4EDE4"
      ],
      "direction": "135deg",
      "stops": [
        "0%",
        "100%"
      ],
      "type": "THEME_COLOR_TYPE_LINEAR"
    },
    "elementFont": {
      "bold": true,
      "color": {
        "colors": [
          "#1F3A5F",
          "#F4EDE4"
        ],
        "direction": "135deg",
        "stops": [
          "0%",
          "100%"
        ],
        "type": "THEME_COLOR_TYPE_LINEAR"
      },
      "family": "PAGE_THEME_FONT_FAMILY_GEORGIA",
      "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
      "fontSize": 18,
      "italic": false
    },
    "footerLogoEnabled": true,
    "footerLogoId": "c3f7a9e1-6d2b-4a8c-b1e5-7d0f3a9c2e64",
    "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "titleFont": {
      "bold": true,
      "color": {
        "colors": [
          "#1F3A5F",
          "#F4EDE4"
        ],
        "direction": "135deg",
        "stops": [
          "0%",
          "100%"
        ],
        "type": "THEME_COLOR_TYPE_LINEAR"
      },
      "family": "PAGE_THEME_FONT_FAMILY_GEORGIA",
      "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
      "fontSize": 18,
      "italic": false
    },
    "updatedAt": "2026-03-18T16:05:00Z",
    "visitorExperience": "PAGE_THEME_VISITOR_EXPERIENCE_CLASSIC",
    "workspaceId": "c0d3cafe-5b1e-4d42-a6fd-0c5f5c3962d0"
  },
  "pageThemeId": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
  "publishedAt": "2026-03-20T10:00:00Z",
  "slug": "lumiere-spring",
  "tags": "restaurant,spring-2026",
  "thumbnailPendingUpdateSince": "2026-03-18T16:05:00Z",
  "thumbnailSignedUrl": "https://cdn.linkbreakers.com/page-theme-templates/0d7f4d9c/thumbnail.png?Expires=1774108800&Signature=b7Xk2pQz9LmN4vR8",
  "updatedAt": "2026-03-18T16:05:00Z",
  "usageCount": 42,
  "workspaceId": "c0d3cafe-5b1e-4d42-a6fd-0c5f5c3962d0"
}
```

### Parameters

`include` array of string 

query

`search` string 

query

`pageSize` integer (int64) 

query

`pageToken` string 

query

`scope` string 

query

Which templates to return. WORKSPACE (default) returns only templates owned by the caller's workspace. AVAILABLE also returns built-in templates and templates other workspaces have published, ordered by the workspace's own usage first, then its own templates, then the rest.

* PAGE\_THEME\_TEMPLATE\_SCOPE\_UNSPECIFIED: Defaults to PAGE\_THEME\_TEMPLATE\_SCOPE\_WORKSPACE.
* PAGE\_THEME\_TEMPLATE\_SCOPE\_WORKSPACE: Only templates owned by the caller's workspace.
* PAGE\_THEME\_TEMPLATE\_SCOPE\_AVAILABLE: Every template the workspace may use: its own, built-in ones, and templates published by other workspaces.

`cursor` string 

query

Opaque cursor from the previous page's nextPageToken. Same as pageToken; when both are sent, pageToken wins.

### Response

200

`hasMore` boolean

Whether another page exists after this result set

`nextPageToken` string

Cursor token for the next page, if any.

Cursor token returned when another page is available

`pageThemeTemplates` array of object

Fields: [The page theme template object](#page-theme-templates-object).

`totalCount` integer (int64)

How many records exist in total, so a client can tell a complete answer from a page of one. A local-first client reads absence from this list as deletion, and may only do so when the count it was given matches what it received: without that, one page would look like the whole model and everything beyond it would be removed locally.

Errors answer 4xx or 5xx with the [error object](https://linkbreakers.com/help/api#errors), and `429` past the [rate limit](https://linkbreakers.com/help/api#rate-limits).

Request

```bash
curl -X GET "https://api.linkbreakers.com/v1/page-theme-templates" \
  -H "Authorization: Bearer $LINKBREAKERS_TOKEN"
```

Response 200

```json
{
  "hasMore": true,
  "nextPageToken": "eyJvZmZzZXQiOjI1fQ",
  "pageThemeTemplates": [
    {
      "badgeSignedUrl": "https://cdn.linkbreakers.com/media/5f1c2d3e/lumiere-badge.png?Expires=1774108800&Signature=b7Xk2pQz9LmN4vR8",
      "builtIn": false,
      "coverSignedUrl": "https://cdn.linkbreakers.com/media/5f1c2d3e/menu-cover.png?Expires=1774108800&Signature=b7Xk2pQz9LmN4vR8",
      "createdAt": "2026-03-14T09:30:00Z",
      "description": "A warm cream page with navy buttons, made for restaurant menus.",
      "duplicatedFrom": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
      "faq": "[{\"id\": \"1\", \"question\": \"Does it work on a phone?\", \"answer\": \"Yes, every page using this template is built for small screens first.\", \"order\": 1}]",
      "footerLogoSignedUrl": "https://cdn.linkbreakers.com/media/5f1c2d3e/lumiere-logo.png?Expires=1774108800&Signature=b7Xk2pQz9LmN4vR8",
      "id": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
      "learnMore": "## Spring menu\n\nWarm cream background, navy buttons and the Inter font, made for restaurant table cards.",
      "name": "Lumiere Spring",
      "owned": true,
      "pageTheme": {
        "badgeEnabled": true,
        "badgeIconColor": {
          "colors": [
            "#1F3A5F",
            "#F4EDE4"
          ],
          "direction": "135deg",
          "stops": [
            "0%",
            "100%"
          ],
          "type": "THEME_COLOR_TYPE_LINEAR"
        },
        "badgeId": "8e4a1c7d-2b9f-4d3e-a5c6-9f0b1e7d3a52",
        "badgeShape": "PAGE_THEME_BADGE_SHAPE_CIRCLE",
        "bodyFont": {
          "bold": true,
          "color": {
            "colors": [
              "#1F3A5F",
              "#F4EDE4"
            ],
            "direction": "135deg",
            "stops": [
              "0%",
              "100%"
            ],
            "type": "THEME_COLOR_TYPE_LINEAR"
          },
          "family": "PAGE_THEME_FONT_FAMILY_GEORGIA",
          "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
          "fontSize": 18,
          "italic": false
        },
        "canvasColor": {
          "colors": [
            "#1F3A5F",
            "#F4EDE4"
          ],
          "direction": "135deg",
          "stops": [
            "0%",
            "100%"
          ],
          "type": "THEME_COLOR_TYPE_LINEAR"
        },
        "canvasCoverId": "5f1c2d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f",
        "canvasCoverMode": "PAGE_THEME_BACKGROUND_COVER_MODE_PROGRESSIVE_TOP",
        "containerConfig": {
          "backgroundColor": {
            "colors": [
              "#1F3A5F",
              "#F4EDE4"
            ],
            "direction": "135deg",
            "stops": [
              "0%",
              "100%"
            ],
            "type": "THEME_COLOR_TYPE_LINEAR"
          },
          "borderColor": {
            "colors": [
              "#1F3A5F",
              "#F4EDE4"
            ],
            "direction": "135deg",
            "stops": [
              "0%",
              "100%"
            ],
            "type": "THEME_COLOR_TYPE_LINEAR"
          },
          "borderSize": 2,
          "borderStyle": "PAGE_THEME_BORDER_STYLE_SOLID",
          "opacity": 90,
          "variant": "PAGE_THEME_CONTAINER_VARIANT_ROUNDED"
        },
        "containerEnabled": true,
        "createdAt": "2026-03-14T09:30:00Z",
        "elementColor": {
          "colors": [
            "#1F3A5F",
            "#F4EDE4"
          ],
          "direction": "135deg",
          "stops": [
            "0%",
            "100%"
          ],
          "type": "THEME_COLOR_TYPE_LINEAR"
        },
        "elementFont": {
          "bold": true,
          "color": {
            "colors": [
              "#1F3A5F",
              "#F4EDE4"
            ],
            "direction": "135deg",
            "stops": [
              "0%",
              "100%"
            ],
            "type": "THEME_COLOR_TYPE_LINEAR"
          },
          "family": "PAGE_THEME_FONT_FAMILY_GEORGIA",
          "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
          "fontSize": 18,
          "italic": false
        },
        "footerLogoEnabled": true,
        "footerLogoId": "c3f7a9e1-6d2b-4a8c-b1e5-7d0f3a9c2e64",
        "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "titleFont": {
          "bold": true,
          "color": {
            "colors": [
              "#1F3A5F",
              "#F4EDE4"
            ],
            "direction": "135deg",
            "stops": [
              "0%",
              "100%"
            ],
            "type": "THEME_COLOR_TYPE_LINEAR"
          },
          "family": "PAGE_THEME_FONT_FAMILY_GEORGIA",
          "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
          "fontSize": 18,
          "italic": false
        },
        "updatedAt": "2026-03-18T16:05:00Z",
        "visitorExperience": "PAGE_THEME_VISITOR_EXPERIENCE_CLASSIC",
        "workspaceId": "c0d3cafe-5b1e-4d42-a6fd-0c5f5c3962d0"
      },
      "pageThemeId": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
      "publishedAt": "2026-03-20T10:00:00Z",
      "slug": "lumiere-spring",
      "tags": "restaurant,spring-2026",
      "thumbnailPendingUpdateSince": "2026-03-18T16:05:00Z",
      "thumbnailSignedUrl": "https://cdn.linkbreakers.com/page-theme-templates/0d7f4d9c/thumbnail.png?Expires=1774108800&Signature=b7Xk2pQz9LmN4vR8",
      "updatedAt": "2026-03-18T16:05:00Z",
      "usageCount": 42,
      "workspaceId": "c0d3cafe-5b1e-4d42-a6fd-0c5f5c3962d0"
    }
  ],
  "totalCount": 24
}
```

### Parameters

`id` string 

path

Required

`include` array of string 

query

### Response

200

Returns [the page theme template object](#page-theme-templates-object).

Errors answer 4xx or 5xx with the [error object](https://linkbreakers.com/help/api#errors), and `429` past the [rate limit](https://linkbreakers.com/help/api#rate-limits).

Request

```bash
curl -X GET "https://api.linkbreakers.com/v1/page-theme-templates/{id}" \
  -H "Authorization: Bearer $LINKBREAKERS_TOKEN"
```

### Parameters

`include` array of string 

query

Related objects to include in the response

List of related objects to include. Supported values: 'workspace'

`search` string 

query

Search query applied to template name/description

`pageSize` integer (int64) 

query

Maximum number of templates to return (defaults to 20)

`pageToken` string 

query

Cursor token to retrieve the next page of results

`workspaceId` string 

query

Optional workspace ID to filter templates by workspace

Filter public templates by workspace. Only published templates for that workspace will be returned.

`cursor` string 

query

Opaque cursor from the previous page's nextPageToken. Same as pageToken; when both are sent, pageToken wins.

### Response

200

`hasMore` boolean

Whether another page exists after this result set

`nextPageToken` string

Cursor token for the next page, if any

`pageThemeTemplates` array of object

14 child attributes

`badgeSignedUrl` string

Signed URL for the template's badge image. Empty when it has no badge.

`builtIn` boolean

Whether the template is maintained by Linkbreakers (available to every workspace)

`coverSignedUrl` string

Signed URL for the template's cover image. Empty when it has no cover.

`description` string

Short marketing description displayed in the template picker

`faq` string

FAQ data stored as JSON.

Frequently Asked Questions about this template stored as JSON

`footerLogoSignedUrl` string

Signed URL for the template's footer logo image. Empty when it has none.

`learnMore` string

Extended markdown-supported content providing detailed information about the template

`name` string

Human-readable name shown in the gallery

`pageTheme` object

The styling itself, so a public gallery can render a live preview rather than only the rasterized thumbnail.

20 child attributes

`badgeEnabled` boolean

\--- Badge Section --- Whether badge is enabled

`badgeIconColor` object

Badge icon background color (used when badge is not selected)

4 child attributes

`colors` array of string 

Required

Color values in render order (hex, rgb/rgba, hsl/hsla).

`direction` string

Optional direction for linear gradients (e.g. "135deg", "to right").

`stops` array of string

Optional stop offsets aligned with `colors` (e.g. "0%", "50%", "100%").

`type` enum 

Required

Color type

Allowed values

* `THEME_COLOR_TYPE_SOLID`
* `THEME_COLOR_TYPE_LINEAR`
* `THEME_COLOR_TYPE_RADIAL`

`badgeId` string

Badge image ID (references media table)

`badgeShape` enum

Shape the badge image is cropped to (circle, square or rounded)

Allowed values

* `PAGE_THEME_BADGE_SHAPE_CIRCLE`
* `PAGE_THEME_BADGE_SHAPE_SQUARE`
* `PAGE_THEME_BADGE_SHAPE_ROUNDED`

`bodyFont` object

Body font configuration

6 child attributes

`bold` boolean

Bold styling

`color` object

Text color (ThemeColor)

`family` enum

Font family (strict enum mapped to native font stacks).

The enum names the seven families the editor offers. Themes can carry a stack outside that set, which has no enum value and reads back as DEFAULT, so familyStack carries the exact one and is what a client should write back when it did not change the font.

Allowed values

* `PAGE_THEME_FONT_FAMILY_DEFAULT`
* `PAGE_THEME_FONT_FAMILY_ARIAL`
* `PAGE_THEME_FONT_FAMILY_HELVETICA`
* `PAGE_THEME_FONT_FAMILY_VERDANA`
* `PAGE_THEME_FONT_FAMILY_GEORGIA`
* `PAGE_THEME_FONT_FAMILY_TIMES_NEW_ROMAN`
* `PAGE_THEME_FONT_FAMILY_COURIER_NEW`
* `PAGE_THEME_FONT_FAMILY_UNSPECIFIED` Maps to the default system sans-serif stack.

`familyStack` string

Exact CSS font stack. Takes precedence over family when writing.

`fontSize` integer (int32)

Font size in pixels

`italic` boolean

Italic styling

`canvasColor` object

\--- Background Section --- Canvas color configuration

4 child attributes

`colors` array of string 

Required

Color values in render order (hex, rgb/rgba, hsl/hsla).

`direction` string

Optional direction for linear gradients (e.g. "135deg", "to right").

`stops` array of string

Optional stop offsets aligned with `colors` (e.g. "0%", "50%", "100%").

`type` enum 

Required

Color type

Allowed values

* `THEME_COLOR_TYPE_SOLID`
* `THEME_COLOR_TYPE_LINEAR`
* `THEME_COLOR_TYPE_RADIAL`

`canvasCoverId` string

Optional cover media ID (references media table)

`canvasCoverMode` enum

Cover display mode

Allowed values

* `PAGE_THEME_BACKGROUND_COVER_MODE_FULL`
* `PAGE_THEME_BACKGROUND_COVER_MODE_PROGRESSIVE_TOP`
* `PAGE_THEME_BACKGROUND_COVER_MODE_PROGRESSIVE_BOTTOM`

`containerConfig` object

Container styling configuration

6 child attributes

`backgroundColor` object

Color filling the container behind its content, solid or gradient

`borderColor` object

Color of the container border, solid or gradient

`borderSize` integer (int32)

Border size in pixels (0 or more)

`borderStyle` enum

Line style of the container border (solid, dashed, dotted...)

Allowed values

* `PAGE_THEME_BORDER_STYLE_SOLID`
* `PAGE_THEME_BORDER_STYLE_DASHED`
* `PAGE_THEME_BORDER_STYLE_DOTTED`
* `PAGE_THEME_BORDER_STYLE_DOUBLE`
* `PAGE_THEME_BORDER_STYLE_GROOVE`
* `PAGE_THEME_BORDER_STYLE_RIDGE`

`opacity` integer (int32)

Opacity (0-100%)

`variant` enum

Container variant (required when containerConfig is set)

Allowed values

* `PAGE_THEME_CONTAINER_VARIANT_ROUNDED`
* `PAGE_THEME_CONTAINER_VARIANT_SQUARE`

`containerEnabled` boolean

Whether container is enabled

`createdAt` string (date-time) 

Read-only

When the page theme was created

`elementColor` object

Interactive element background color configuration

4 child attributes

`colors` array of string 

Required

Color values in render order (hex, rgb/rgba, hsl/hsla).

`direction` string

Optional direction for linear gradients (e.g. "135deg", "to right").

`stops` array of string

Optional stop offsets aligned with `colors` (e.g. "0%", "50%", "100%").

`type` enum 

Required

Color type

Allowed values

* `THEME_COLOR_TYPE_SOLID`
* `THEME_COLOR_TYPE_LINEAR`
* `THEME_COLOR_TYPE_RADIAL`

`elementFont` object

Interactive element text font configuration

6 child attributes

`bold` boolean

Bold styling

`color` object

Text color (ThemeColor)

`family` enum

Font family (strict enum mapped to native font stacks).

The enum names the seven families the editor offers. Themes can carry a stack outside that set, which has no enum value and reads back as DEFAULT, so familyStack carries the exact one and is what a client should write back when it did not change the font.

Allowed values

* `PAGE_THEME_FONT_FAMILY_DEFAULT`
* `PAGE_THEME_FONT_FAMILY_ARIAL`
* `PAGE_THEME_FONT_FAMILY_HELVETICA`
* `PAGE_THEME_FONT_FAMILY_VERDANA`
* `PAGE_THEME_FONT_FAMILY_GEORGIA`
* `PAGE_THEME_FONT_FAMILY_TIMES_NEW_ROMAN`
* `PAGE_THEME_FONT_FAMILY_COURIER_NEW`
* `PAGE_THEME_FONT_FAMILY_UNSPECIFIED` Maps to the default system sans-serif stack.

`familyStack` string

Exact CSS font stack. Takes precedence over family when writing.

`fontSize` integer (int32)

Font size in pixels

`italic` boolean

Italic styling

`footerLogoEnabled` boolean

Whether the footer logo (a small company or brand logo centered at the bottom of every page using this theme) is shown.

Turning it off keeps footerLogoId, so turning it back on restores the same image.

`footerLogoId` string

Footer logo image ID (a media library image)

`id` string 

Read-only

Page theme ID

`titleFont` object

\--- Typography Section --- Title font configuration

6 child attributes

`bold` boolean

Bold styling

`color` object

Text color (ThemeColor)

`family` enum

Font family (strict enum mapped to native font stacks).

The enum names the seven families the editor offers. Themes can carry a stack outside that set, which has no enum value and reads back as DEFAULT, so familyStack carries the exact one and is what a client should write back when it did not change the font.

Allowed values

* `PAGE_THEME_FONT_FAMILY_DEFAULT`
* `PAGE_THEME_FONT_FAMILY_ARIAL`
* `PAGE_THEME_FONT_FAMILY_HELVETICA`
* `PAGE_THEME_FONT_FAMILY_VERDANA`
* `PAGE_THEME_FONT_FAMILY_GEORGIA`
* `PAGE_THEME_FONT_FAMILY_TIMES_NEW_ROMAN`
* `PAGE_THEME_FONT_FAMILY_COURIER_NEW`
* `PAGE_THEME_FONT_FAMILY_UNSPECIFIED` Maps to the default system sans-serif stack.

`familyStack` string

Exact CSS font stack. Takes precedence over family when writing.

`fontSize` integer (int32)

Font size in pixels

`italic` boolean

Italic styling

`updatedAt` string (date-time) 

Read-only

When the page theme was last updated

`visitorExperience` enum

How visitor pages pace their content. Unset reads as CLASSIC.

Allowed values

* `PAGE_THEME_VISITOR_EXPERIENCE_CLASSIC`
* `PAGE_THEME_VISITOR_EXPERIENCE_FOCUSED`

`workspaceId` string 

Read-only

Workspace ID this page theme belongs to

`publishedAt` string (date-time)

When the template was published and made available to all workspaces

`slug` string

Slug used in public template selection URLs

`tags` string

Tags for categorizing and filtering templates (comma-separated)

`thumbnailSignedUrl` string

Signed thumbnail preview of the template styling

`workspace` object

Public information about the workspace that created this template. Empty for built-in templates. Only included when 'workspace' is specified in the include parameter.

8 child attributes

`description` string

Optional description providing additional context about the workspace

`faq` string

FAQ data stored as JSON.

Frequently Asked Questions about this workspace stored as JSON

`name` string

Human-readable display name

`publishedAt` string (date-time)

Timestamp when the workspace was published/made public

`shortDescription` string

Short description for the workspace

`slug` string

Unique slug for the workspace (URL-friendly identifier)

`tags` string

Comma-separated tags for the workspace

`website` string

Website URL for the workspace

Errors answer 4xx or 5xx with the [error object](https://linkbreakers.com/help/api#errors), and `429` past the [rate limit](https://linkbreakers.com/help/api#rate-limits).

Request

```bash
curl -X GET "https://api.linkbreakers.com/v1/public/page-theme-templates"
```

Response 200

```json
{
  "hasMore": true,
  "nextPageToken": "eyJvZmZzZXQiOjI1fQ",
  "pageThemeTemplates": [
    {
      "badgeSignedUrl": "https://cdn.linkbreakers.com/media/5f1c2d3e/lumiere-badge.png?Expires=1774108800&Signature=b7Xk2pQz9LmN4vR8",
      "builtIn": false,
      "coverSignedUrl": "https://cdn.linkbreakers.com/media/5f1c2d3e/menu-cover.png?Expires=1774108800&Signature=b7Xk2pQz9LmN4vR8",
      "description": "A warm cream page with navy buttons, made for restaurant menus.",
      "faq": "[{\"id\": \"1\", \"question\": \"Does it work on a phone?\", \"answer\": \"Yes, every page using this template is built for small screens first.\", \"order\": 1}]",
      "footerLogoSignedUrl": "https://cdn.linkbreakers.com/media/5f1c2d3e/lumiere-logo.png?Expires=1774108800&Signature=b7Xk2pQz9LmN4vR8",
      "learnMore": "## Spring menu\n\nWarm cream background, navy buttons and the Inter font, made for restaurant table cards.",
      "name": "Lumiere Spring",
      "pageTheme": {
        "badgeEnabled": true,
        "badgeIconColor": {
          "colors": [
            "#1F3A5F",
            "#F4EDE4"
          ],
          "direction": "135deg",
          "stops": [
            "0%",
            "100%"
          ],
          "type": "THEME_COLOR_TYPE_LINEAR"
        },
        "badgeId": "8e4a1c7d-2b9f-4d3e-a5c6-9f0b1e7d3a52",
        "badgeShape": "PAGE_THEME_BADGE_SHAPE_CIRCLE",
        "bodyFont": {
          "bold": true,
          "color": {
            "colors": [
              "#1F3A5F",
              "#F4EDE4"
            ],
            "direction": "135deg",
            "stops": [
              "0%",
              "100%"
            ],
            "type": "THEME_COLOR_TYPE_LINEAR"
          },
          "family": "PAGE_THEME_FONT_FAMILY_GEORGIA",
          "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
          "fontSize": 18,
          "italic": false
        },
        "canvasColor": {
          "colors": [
            "#1F3A5F",
            "#F4EDE4"
          ],
          "direction": "135deg",
          "stops": [
            "0%",
            "100%"
          ],
          "type": "THEME_COLOR_TYPE_LINEAR"
        },
        "canvasCoverId": "5f1c2d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f",
        "canvasCoverMode": "PAGE_THEME_BACKGROUND_COVER_MODE_PROGRESSIVE_TOP",
        "containerConfig": {
          "backgroundColor": {
            "colors": [
              "#1F3A5F",
              "#F4EDE4"
            ],
            "direction": "135deg",
            "stops": [
              "0%",
              "100%"
            ],
            "type": "THEME_COLOR_TYPE_LINEAR"
          },
          "borderColor": {
            "colors": [
              "#1F3A5F",
              "#F4EDE4"
            ],
            "direction": "135deg",
            "stops": [
              "0%",
              "100%"
            ],
            "type": "THEME_COLOR_TYPE_LINEAR"
          },
          "borderSize": 2,
          "borderStyle": "PAGE_THEME_BORDER_STYLE_SOLID",
          "opacity": 90,
          "variant": "PAGE_THEME_CONTAINER_VARIANT_ROUNDED"
        },
        "containerEnabled": true,
        "createdAt": "2026-03-14T09:30:00Z",
        "elementColor": {
          "colors": [
            "#1F3A5F",
            "#F4EDE4"
          ],
          "direction": "135deg",
          "stops": [
            "0%",
            "100%"
          ],
          "type": "THEME_COLOR_TYPE_LINEAR"
        },
        "elementFont": {
          "bold": true,
          "color": {
            "colors": [
              "#1F3A5F",
              "#F4EDE4"
            ],
            "direction": "135deg",
            "stops": [
              "0%",
              "100%"
            ],
            "type": "THEME_COLOR_TYPE_LINEAR"
          },
          "family": "PAGE_THEME_FONT_FAMILY_GEORGIA",
          "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
          "fontSize": 18,
          "italic": false
        },
        "footerLogoEnabled": true,
        "footerLogoId": "c3f7a9e1-6d2b-4a8c-b1e5-7d0f3a9c2e64",
        "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "titleFont": {
          "bold": true,
          "color": {
            "colors": [
              "#1F3A5F",
              "#F4EDE4"
            ],
            "direction": "135deg",
            "stops": [
              "0%",
              "100%"
            ],
            "type": "THEME_COLOR_TYPE_LINEAR"
          },
          "family": "PAGE_THEME_FONT_FAMILY_GEORGIA",
          "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
          "fontSize": 18,
          "italic": false
        },
        "updatedAt": "2026-03-18T16:05:00Z",
        "visitorExperience": "PAGE_THEME_VISITOR_EXPERIENCE_CLASSIC",
        "workspaceId": "c0d3cafe-5b1e-4d42-a6fd-0c5f5c3962d0"
      },
      "publishedAt": "2026-03-20T10:00:00Z",
      "slug": "lumiere-spring",
      "tags": "restaurant,spring-2026",
      "thumbnailSignedUrl": "https://cdn.linkbreakers.com/page-theme-templates/0d7f4d9c/thumbnail.png?Expires=1774108800&Signature=b7Xk2pQz9LmN4vR8",
      "workspace": {
        "description": "Boutique hotel in Lyon with a restaurant and a rooftop bar. Our QR codes sit on restaurant tables, flyers and posters.",
        "faq": "[{\"id\": \"1\", \"question\": \"Is breakfast included?\", \"answer\": \"Yes, breakfast is served from 7:00 to 10:30.\", \"order\": 0}]",
        "name": "Hotel Lumiere",
        "publishedAt": "2026-03-16T11:00:00Z",
        "shortDescription": "Boutique hotel and restaurant in Lyon",
        "slug": "hotel-lumiere",
        "tags": "hotel,restaurant,lyon",
        "website": "https://example.com"
      }
    }
  ]
}
```

### Parameters

`slug` string 

path

Required

`include` array of string 

query

Related objects to include in the response

List of related objects to include. Supported values: 'workspace'

### Response

200

`badgeSignedUrl` string

Signed URL for the template's badge image. Empty when it has no badge.

`builtIn` boolean

Whether the template is maintained by Linkbreakers (available to every workspace)

`coverSignedUrl` string

Signed URL for the template's cover image. Empty when it has no cover.

`description` string

Short marketing description displayed in the template picker

`faq` string

FAQ data stored as JSON.

Frequently Asked Questions about this template stored as JSON

`footerLogoSignedUrl` string

Signed URL for the template's footer logo image. Empty when it has none.

`learnMore` string

Extended markdown-supported content providing detailed information about the template

`name` string

Human-readable name shown in the gallery

`pageTheme` object

The styling itself, so a public gallery can render a live preview rather than only the rasterized thumbnail.

20 child attributes, the same as [pageTheme in the page theme template object](#page-theme-templates-object-pagetheme).

`publishedAt` string (date-time)

When the template was published and made available to all workspaces

`slug` string

Slug used in public template selection URLs

`tags` string

Tags for categorizing and filtering templates (comma-separated)

`thumbnailSignedUrl` string

Signed thumbnail preview of the template styling

`workspace` object

Public information about the workspace that created this template. Empty for built-in templates. Only included when 'workspace' is specified in the include parameter.

8 child attributes

`description` string

Optional description providing additional context about the workspace

`faq` string

FAQ data stored as JSON.

Frequently Asked Questions about this workspace stored as JSON

`name` string

Human-readable display name

`publishedAt` string (date-time)

Timestamp when the workspace was published/made public

`shortDescription` string

Short description for the workspace

`slug` string

Unique slug for the workspace (URL-friendly identifier)

`tags` string

Comma-separated tags for the workspace

`website` string

Website URL for the workspace

Errors answer 4xx or 5xx with the [error object](https://linkbreakers.com/help/api#errors), and `429` past the [rate limit](https://linkbreakers.com/help/api#rate-limits).

Request

```bash
curl -X GET "https://api.linkbreakers.com/v1/public/page-theme-templates/{slug}"
```

Response 200

```json
{
  "badgeSignedUrl": "https://cdn.linkbreakers.com/media/5f1c2d3e/lumiere-badge.png?Expires=1774108800&Signature=b7Xk2pQz9LmN4vR8",
  "builtIn": false,
  "coverSignedUrl": "https://cdn.linkbreakers.com/media/5f1c2d3e/menu-cover.png?Expires=1774108800&Signature=b7Xk2pQz9LmN4vR8",
  "description": "A warm cream page with navy buttons, made for restaurant menus.",
  "faq": "[{\"id\": \"1\", \"question\": \"Does it work on a phone?\", \"answer\": \"Yes, every page using this template is built for small screens first.\", \"order\": 1}]",
  "footerLogoSignedUrl": "https://cdn.linkbreakers.com/media/5f1c2d3e/lumiere-logo.png?Expires=1774108800&Signature=b7Xk2pQz9LmN4vR8",
  "learnMore": "## Spring menu\n\nWarm cream background, navy buttons and the Inter font, made for restaurant table cards.",
  "name": "Lumiere Spring",
  "pageTheme": {
    "badgeEnabled": true,
    "badgeIconColor": {
      "colors": [
        "#1F3A5F",
        "#F4EDE4"
      ],
      "direction": "135deg",
      "stops": [
        "0%",
        "100%"
      ],
      "type": "THEME_COLOR_TYPE_LINEAR"
    },
    "badgeId": "8e4a1c7d-2b9f-4d3e-a5c6-9f0b1e7d3a52",
    "badgeShape": "PAGE_THEME_BADGE_SHAPE_CIRCLE",
    "bodyFont": {
      "bold": true,
      "color": {
        "colors": [
          "#1F3A5F",
          "#F4EDE4"
        ],
        "direction": "135deg",
        "stops": [
          "0%",
          "100%"
        ],
        "type": "THEME_COLOR_TYPE_LINEAR"
      },
      "family": "PAGE_THEME_FONT_FAMILY_GEORGIA",
      "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
      "fontSize": 18,
      "italic": false
    },
    "canvasColor": {
      "colors": [
        "#1F3A5F",
        "#F4EDE4"
      ],
      "direction": "135deg",
      "stops": [
        "0%",
        "100%"
      ],
      "type": "THEME_COLOR_TYPE_LINEAR"
    },
    "canvasCoverId": "5f1c2d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f",
    "canvasCoverMode": "PAGE_THEME_BACKGROUND_COVER_MODE_PROGRESSIVE_TOP",
    "containerConfig": {
      "backgroundColor": {
        "colors": [
          "#1F3A5F",
          "#F4EDE4"
        ],
        "direction": "135deg",
        "stops": [
          "0%",
          "100%"
        ],
        "type": "THEME_COLOR_TYPE_LINEAR"
      },
      "borderColor": {
        "colors": [
          "#1F3A5F",
          "#F4EDE4"
        ],
        "direction": "135deg",
        "stops": [
          "0%",
          "100%"
        ],
        "type": "THEME_COLOR_TYPE_LINEAR"
      },
      "borderSize": 2,
      "borderStyle": "PAGE_THEME_BORDER_STYLE_SOLID",
      "opacity": 90,
      "variant": "PAGE_THEME_CONTAINER_VARIANT_ROUNDED"
    },
    "containerEnabled": true,
    "createdAt": "2026-03-14T09:30:00Z",
    "elementColor": {
      "colors": [
        "#1F3A5F",
        "#F4EDE4"
      ],
      "direction": "135deg",
      "stops": [
        "0%",
        "100%"
      ],
      "type": "THEME_COLOR_TYPE_LINEAR"
    },
    "elementFont": {
      "bold": true,
      "color": {
        "colors": [
          "#1F3A5F",
          "#F4EDE4"
        ],
        "direction": "135deg",
        "stops": [
          "0%",
          "100%"
        ],
        "type": "THEME_COLOR_TYPE_LINEAR"
      },
      "family": "PAGE_THEME_FONT_FAMILY_GEORGIA",
      "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
      "fontSize": 18,
      "italic": false
    },
    "footerLogoEnabled": true,
    "footerLogoId": "c3f7a9e1-6d2b-4a8c-b1e5-7d0f3a9c2e64",
    "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "titleFont": {
      "bold": true,
      "color": {
        "colors": [
          "#1F3A5F",
          "#F4EDE4"
        ],
        "direction": "135deg",
        "stops": [
          "0%",
          "100%"
        ],
        "type": "THEME_COLOR_TYPE_LINEAR"
      },
      "family": "PAGE_THEME_FONT_FAMILY_GEORGIA",
      "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
      "fontSize": 18,
      "italic": false
    },
    "updatedAt": "2026-03-18T16:05:00Z",
    "visitorExperience": "PAGE_THEME_VISITOR_EXPERIENCE_CLASSIC",
    "workspaceId": "c0d3cafe-5b1e-4d42-a6fd-0c5f5c3962d0"
  },
  "publishedAt": "2026-03-20T10:00:00Z",
  "slug": "lumiere-spring",
  "tags": "restaurant,spring-2026",
  "thumbnailSignedUrl": "https://cdn.linkbreakers.com/page-theme-templates/0d7f4d9c/thumbnail.png?Expires=1774108800&Signature=b7Xk2pQz9LmN4vR8",
  "workspace": {
    "description": "Boutique hotel in Lyon with a restaurant and a rooftop bar. Our QR codes sit on restaurant tables, flyers and posters.",
    "faq": "[{\"id\": \"1\", \"question\": \"Is breakfast included?\", \"answer\": \"Yes, breakfast is served from 7:00 to 10:30.\", \"order\": 0}]",
    "name": "Hotel Lumiere",
    "publishedAt": "2026-03-16T11:00:00Z",
    "shortDescription": "Boutique hotel and restaurant in Lyon",
    "slug": "hotel-lumiere",
    "tags": "hotel,restaurant,lyon",
    "website": "https://example.com"
  }
}
```

### Parameters

`Idempotency-Key` string 

header

A unique value per request, such as a UUID, that makes retrying it safe: a retry with the same key and body returns the first response instead of acting twice.

### Request body

`description` string

The description of the page theme template

`faq` string

FAQ data stored as JSON

`learnMore` string

Extended markdown-supported content for "learn more" section

`name` string

The name of the page theme template

`sourcePageThemeId` string

Page theme to copy the styling from, usually a link's own theme. Omit to start from the default styling.

`styling` object

Styling to capture, taking precedence over sourcePageThemeId.

The editor sends what is on screen, so saving a theme as a template records the look the user is actually looking at rather than the last saved one.

16 child attributes

`badge` object

Picks an image from the workspace's media library, or removes it. Any ready image of at most 3 MB can be a background cover, badge or footer logo, wherever it was uploaded from; anything else is refused with MEDIA\_NOT\_ALLOWED\_HERE, whose metadata names the slot, the reason (KIND\_NOT\_ACCEPTED or TOO\_LARGE) and the limit.

2 child attributes

`delete` object

`id` string

`badgeEnabled` boolean

\--- Badge Section ---

`badgeIconColor` object

A color used across the design APIs (page themes, QR code designs). Solid or gradient, with an optional direction and per-stop offsets.

4 child attributes

`colors` array of string 

Required

Color values in render order (hex, rgb/rgba, hsl/hsla).

`direction` string

Optional direction for linear gradients (e.g. "135deg", "to right").

`stops` array of string

Optional stop offsets aligned with `colors` (e.g. "0%", "50%", "100%").

`type` enum 

Required

Color type

Allowed values

* `THEME_COLOR_TYPE_SOLID`
* `THEME_COLOR_TYPE_LINEAR`
* `THEME_COLOR_TYPE_RADIAL`

`badgeShape` enum

Allowed values

* `PAGE_THEME_BADGE_SHAPE_CIRCLE`
* `PAGE_THEME_BADGE_SHAPE_SQUARE`
* `PAGE_THEME_BADGE_SHAPE_ROUNDED`

`bodyFont` object

Font configuration with family, styling, and color

6 child attributes, the same as [pageTheme.bodyFont in the page theme template object](#page-theme-templates-object-pagetheme-bodyfont).

`canvasColor` object

\--- Background Section ---

4 child attributes

`colors` array of string 

Required

Color values in render order (hex, rgb/rgba, hsl/hsla).

`direction` string

Optional direction for linear gradients (e.g. "135deg", "to right").

`stops` array of string

Optional stop offsets aligned with `colors` (e.g. "0%", "50%", "100%").

`type` enum 

Required

Color type

Allowed values

* `THEME_COLOR_TYPE_SOLID`
* `THEME_COLOR_TYPE_LINEAR`
* `THEME_COLOR_TYPE_RADIAL`

`canvasCover` object

Picks an image from the workspace's media library, or removes it. Any ready image of at most 3 MB can be a background cover, badge or footer logo, wherever it was uploaded from; anything else is refused with MEDIA\_NOT\_ALLOWED\_HERE, whose metadata names the slot, the reason (KIND\_NOT\_ACCEPTED or TOO\_LARGE) and the limit.

2 child attributes

`delete` object

`id` string

`canvasCoverMode` enum

Allowed values

* `PAGE_THEME_BACKGROUND_COVER_MODE_FULL`
* `PAGE_THEME_BACKGROUND_COVER_MODE_PROGRESSIVE_TOP`
* `PAGE_THEME_BACKGROUND_COVER_MODE_PROGRESSIVE_BOTTOM`

`containerConfig` object

Container styling configuration

6 child attributes, the same as [pageTheme.containerConfig in the page theme template object](#page-theme-templates-object-pagetheme-containerconfig).

`containerEnabled` boolean

`elementColor` object

A color used across the design APIs (page themes, QR code designs). Solid or gradient, with an optional direction and per-stop offsets.

4 child attributes

`colors` array of string 

Required

Color values in render order (hex, rgb/rgba, hsl/hsla).

`direction` string

Optional direction for linear gradients (e.g. "135deg", "to right").

`stops` array of string

Optional stop offsets aligned with `colors` (e.g. "0%", "50%", "100%").

`type` enum 

Required

Color type

Allowed values

* `THEME_COLOR_TYPE_SOLID`
* `THEME_COLOR_TYPE_LINEAR`
* `THEME_COLOR_TYPE_RADIAL`

`elementFont` object

Font configuration with family, styling, and color

6 child attributes, the same as [pageTheme.bodyFont in the page theme template object](#page-theme-templates-object-pagetheme-bodyfont).

`footerLogo` object

Picks an image from the workspace's media library, or removes it. Any ready image of at most 3 MB can be a background cover, badge or footer logo, wherever it was uploaded from; anything else is refused with MEDIA\_NOT\_ALLOWED\_HERE, whose metadata names the slot, the reason (KIND\_NOT\_ACCEPTED or TOO\_LARGE) and the limit.

2 child attributes

`delete` object

`id` string

`footerLogoEnabled` boolean

Small company or brand logo centered at the bottom of every page using the theme.

`titleFont` object

\--- Typography Section ---

6 child attributes, the same as [pageTheme.bodyFont in the page theme template object](#page-theme-templates-object-pagetheme-bodyfont).

`visitorExperience` enum

How visitor pages pace their content: CLASSIC shows a whole form at once, FOCUSED one question per screen.

Allowed values

* `PAGE_THEME_VISITOR_EXPERIENCE_CLASSIC`
* `PAGE_THEME_VISITOR_EXPERIENCE_FOCUSED`

`tags` string

Tags for categorizing and filtering templates (comma-separated)

### Response

200

`pageThemeTemplate` object

The created page theme template

Fields: [The page theme template object](#page-theme-templates-object).

Errors answer 4xx or 5xx with the [error object](https://linkbreakers.com/help/api#errors), and `429` past the [rate limit](https://linkbreakers.com/help/api#rate-limits).

Request

```bash
curl -X POST "https://api.linkbreakers.com/v1/page-theme-templates" \
  -H "Authorization: Bearer $LINKBREAKERS_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{
  "description": "A warm cream page with navy buttons, made for restaurant menus.",
  "faq": "[{\"id\": \"1\", \"question\": \"Does it work on a phone?\", \"answer\": \"Yes, every page using this template is built for small screens first.\", \"order\": 1}]",
  "learnMore": "## Spring menu\n\nWarm cream background, navy buttons and the Inter font, made for restaurant table cards.",
  "name": "Lumiere Spring",
  "sourcePageThemeId": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
  "styling": {
    "badge": {
      "delete": {},
      "id": "5f1c2d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f"
    },
    "badgeEnabled": true,
    "badgeIconColor": {
      "colors": [
        "#1F3A5F",
        "#F4EDE4"
      ],
      "direction": "135deg",
      "stops": [
        "0%",
        "100%"
      ],
      "type": "THEME_COLOR_TYPE_LINEAR"
    },
    "badgeShape": "PAGE_THEME_BADGE_SHAPE_CIRCLE",
    "bodyFont": {
      "bold": true,
      "color": {
        "colors": [
          "#1F3A5F",
          "#F4EDE4"
        ],
        "direction": "135deg",
        "stops": [
          "0%",
          "100%"
        ],
        "type": "THEME_COLOR_TYPE_LINEAR"
      },
      "family": "PAGE_THEME_FONT_FAMILY_GEORGIA",
      "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
      "fontSize": 18,
      "italic": false
    },
    "canvasColor": {
      "colors": [
        "#1F3A5F",
        "#F4EDE4"
      ],
      "direction": "135deg",
      "stops": [
        "0%",
        "100%"
      ],
      "type": "THEME_COLOR_TYPE_LINEAR"
    },
    "canvasCover": {
      "delete": {},
      "id": "5f1c2d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f"
    },
    "canvasCoverMode": "PAGE_THEME_BACKGROUND_COVER_MODE_PROGRESSIVE_TOP",
    "containerConfig": {
      "backgroundColor": {
        "colors": [
          "#1F3A5F",
          "#F4EDE4"
        ],
        "direction": "135deg",
        "stops": [
          "0%",
          "100%"
        ],
        "type": "THEME_COLOR_TYPE_LINEAR"
      },
      "borderColor": {
        "colors": [
          "#1F3A5F",
          "#F4EDE4"
        ],
        "direction": "135deg",
        "stops": [
          "0%",
          "100%"
        ],
        "type": "THEME_COLOR_TYPE_LINEAR"
      },
      "borderSize": 2,
      "borderStyle": "PAGE_THEME_BORDER_STYLE_SOLID",
      "opacity": 90,
      "variant": "PAGE_THEME_CONTAINER_VARIANT_ROUNDED"
    },
    "containerEnabled": true,
    "elementColor": {
      "colors": [
        "#1F3A5F",
        "#F4EDE4"
      ],
      "direction": "135deg",
      "stops": [
        "0%",
        "100%"
      ],
      "type": "THEME_COLOR_TYPE_LINEAR"
    },
    "elementFont": {
      "bold": true,
      "color": {
        "colors": [
          "#1F3A5F",
          "#F4EDE4"
        ],
        "direction": "135deg",
        "stops": [
          "0%",
          "100%"
        ],
        "type": "THEME_COLOR_TYPE_LINEAR"
      },
      "family": "PAGE_THEME_FONT_FAMILY_GEORGIA",
      "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
      "fontSize": 18,
      "italic": false
    },
    "footerLogo": {
      "delete": {},
      "id": "5f1c2d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f"
    },
    "footerLogoEnabled": true,
    "titleFont": {
      "bold": true,
      "color": {
        "colors": [
          "#1F3A5F",
          "#F4EDE4"
        ],
        "direction": "135deg",
        "stops": [
          "0%",
          "100%"
        ],
        "type": "THEME_COLOR_TYPE_LINEAR"
      },
      "family": "PAGE_THEME_FONT_FAMILY_GEORGIA",
      "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
      "fontSize": 18,
      "italic": false
    },
    "visitorExperience": "PAGE_THEME_VISITOR_EXPERIENCE_FOCUSED"
  },
  "tags": "restaurant,spring-2026"
}'
```

Response 200

```json
{
  "pageThemeTemplate": {
    "badgeSignedUrl": "https://cdn.linkbreakers.com/media/5f1c2d3e/lumiere-badge.png?Expires=1774108800&Signature=b7Xk2pQz9LmN4vR8",
    "builtIn": false,
    "coverSignedUrl": "https://cdn.linkbreakers.com/media/5f1c2d3e/menu-cover.png?Expires=1774108800&Signature=b7Xk2pQz9LmN4vR8",
    "createdAt": "2026-03-14T09:30:00Z",
    "description": "A warm cream page with navy buttons, made for restaurant menus.",
    "duplicatedFrom": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
    "faq": "[{\"id\": \"1\", \"question\": \"Does it work on a phone?\", \"answer\": \"Yes, every page using this template is built for small screens first.\", \"order\": 1}]",
    "footerLogoSignedUrl": "https://cdn.linkbreakers.com/media/5f1c2d3e/lumiere-logo.png?Expires=1774108800&Signature=b7Xk2pQz9LmN4vR8",
    "id": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
    "learnMore": "## Spring menu\n\nWarm cream background, navy buttons and the Inter font, made for restaurant table cards.",
    "name": "Lumiere Spring",
    "owned": true,
    "pageTheme": {
      "badgeEnabled": true,
      "badgeIconColor": {
        "colors": [
          "#1F3A5F",
          "#F4EDE4"
        ],
        "direction": "135deg",
        "stops": [
          "0%",
          "100%"
        ],
        "type": "THEME_COLOR_TYPE_LINEAR"
      },
      "badgeId": "8e4a1c7d-2b9f-4d3e-a5c6-9f0b1e7d3a52",
      "badgeShape": "PAGE_THEME_BADGE_SHAPE_CIRCLE",
      "bodyFont": {
        "bold": true,
        "color": {
          "colors": [
            "#1F3A5F",
            "#F4EDE4"
          ],
          "direction": "135deg",
          "stops": [
            "0%",
            "100%"
          ],
          "type": "THEME_COLOR_TYPE_LINEAR"
        },
        "family": "PAGE_THEME_FONT_FAMILY_GEORGIA",
        "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
        "fontSize": 18,
        "italic": false
      },
      "canvasColor": {
        "colors": [
          "#1F3A5F",
          "#F4EDE4"
        ],
        "direction": "135deg",
        "stops": [
          "0%",
          "100%"
        ],
        "type": "THEME_COLOR_TYPE_LINEAR"
      },
      "canvasCoverId": "5f1c2d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f",
      "canvasCoverMode": "PAGE_THEME_BACKGROUND_COVER_MODE_PROGRESSIVE_TOP",
      "containerConfig": {
        "backgroundColor": {
          "colors": [
            "#1F3A5F",
            "#F4EDE4"
          ],
          "direction": "135deg",
          "stops": [
            "0%",
            "100%"
          ],
          "type": "THEME_COLOR_TYPE_LINEAR"
        },
        "borderColor": {
          "colors": [
            "#1F3A5F",
            "#F4EDE4"
          ],
          "direction": "135deg",
          "stops": [
            "0%",
            "100%"
          ],
          "type": "THEME_COLOR_TYPE_LINEAR"
        },
        "borderSize": 2,
        "borderStyle": "PAGE_THEME_BORDER_STYLE_SOLID",
        "opacity": 90,
        "variant": "PAGE_THEME_CONTAINER_VARIANT_ROUNDED"
      },
      "containerEnabled": true,
      "createdAt": "2026-03-14T09:30:00Z",
      "elementColor": {
        "colors": [
          "#1F3A5F",
          "#F4EDE4"
        ],
        "direction": "135deg",
        "stops": [
          "0%",
          "100%"
        ],
        "type": "THEME_COLOR_TYPE_LINEAR"
      },
      "elementFont": {
        "bold": true,
        "color": {
          "colors": [
            "#1F3A5F",
            "#F4EDE4"
          ],
          "direction": "135deg",
          "stops": [
            "0%",
            "100%"
          ],
          "type": "THEME_COLOR_TYPE_LINEAR"
        },
        "family": "PAGE_THEME_FONT_FAMILY_GEORGIA",
        "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
        "fontSize": 18,
        "italic": false
      },
      "footerLogoEnabled": true,
      "footerLogoId": "c3f7a9e1-6d2b-4a8c-b1e5-7d0f3a9c2e64",
      "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "titleFont": {
        "bold": true,
        "color": {
          "colors": [
            "#1F3A5F",
            "#F4EDE4"
          ],
          "direction": "135deg",
          "stops": [
            "0%",
            "100%"
          ],
          "type": "THEME_COLOR_TYPE_LINEAR"
        },
        "family": "PAGE_THEME_FONT_FAMILY_GEORGIA",
        "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
        "fontSize": 18,
        "italic": false
      },
      "updatedAt": "2026-03-18T16:05:00Z",
      "visitorExperience": "PAGE_THEME_VISITOR_EXPERIENCE_CLASSIC",
      "workspaceId": "c0d3cafe-5b1e-4d42-a6fd-0c5f5c3962d0"
    },
    "pageThemeId": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
    "publishedAt": "2026-03-20T10:00:00Z",
    "slug": "lumiere-spring",
    "tags": "restaurant,spring-2026",
    "thumbnailPendingUpdateSince": "2026-03-18T16:05:00Z",
    "thumbnailSignedUrl": "https://cdn.linkbreakers.com/page-theme-templates/0d7f4d9c/thumbnail.png?Expires=1774108800&Signature=b7Xk2pQz9LmN4vR8",
    "updatedAt": "2026-03-18T16:05:00Z",
    "usageCount": 42,
    "workspaceId": "c0d3cafe-5b1e-4d42-a6fd-0c5f5c3962d0"
  }
}
```

### Parameters

`id` string 

path

Required

The ID of the page theme template to publish (UUID)

`Idempotency-Key` string 

header

A unique value per request, such as a UUID, that makes retrying it safe: a retry with the same key and body returns the first response instead of acting twice.

### Request body

An empty JSON object.

### Response

200

`pageThemeTemplate` object

The published page theme template

Fields: [The page theme template object](#page-theme-templates-object).

Errors answer 4xx or 5xx with the [error object](https://linkbreakers.com/help/api#errors), and `429` past the [rate limit](https://linkbreakers.com/help/api#rate-limits).

Request

```bash
curl -X POST "https://api.linkbreakers.com/v1/page-theme-templates/{id}/publish" \
  -H "Authorization: Bearer $LINKBREAKERS_TOKEN" \
  -H "Content-Type: application/json"
```

Response 200

```json
{
  "pageThemeTemplate": {
    "badgeSignedUrl": "https://cdn.linkbreakers.com/media/5f1c2d3e/lumiere-badge.png?Expires=1774108800&Signature=b7Xk2pQz9LmN4vR8",
    "builtIn": false,
    "coverSignedUrl": "https://cdn.linkbreakers.com/media/5f1c2d3e/menu-cover.png?Expires=1774108800&Signature=b7Xk2pQz9LmN4vR8",
    "createdAt": "2026-03-14T09:30:00Z",
    "description": "A warm cream page with navy buttons, made for restaurant menus.",
    "duplicatedFrom": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
    "faq": "[{\"id\": \"1\", \"question\": \"Does it work on a phone?\", \"answer\": \"Yes, every page using this template is built for small screens first.\", \"order\": 1}]",
    "footerLogoSignedUrl": "https://cdn.linkbreakers.com/media/5f1c2d3e/lumiere-logo.png?Expires=1774108800&Signature=b7Xk2pQz9LmN4vR8",
    "id": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
    "learnMore": "## Spring menu\n\nWarm cream background, navy buttons and the Inter font, made for restaurant table cards.",
    "name": "Lumiere Spring",
    "owned": true,
    "pageTheme": {
      "badgeEnabled": true,
      "badgeIconColor": {
        "colors": [
          "#1F3A5F",
          "#F4EDE4"
        ],
        "direction": "135deg",
        "stops": [
          "0%",
          "100%"
        ],
        "type": "THEME_COLOR_TYPE_LINEAR"
      },
      "badgeId": "8e4a1c7d-2b9f-4d3e-a5c6-9f0b1e7d3a52",
      "badgeShape": "PAGE_THEME_BADGE_SHAPE_CIRCLE",
      "bodyFont": {
        "bold": true,
        "color": {
          "colors": [
            "#1F3A5F",
            "#F4EDE4"
          ],
          "direction": "135deg",
          "stops": [
            "0%",
            "100%"
          ],
          "type": "THEME_COLOR_TYPE_LINEAR"
        },
        "family": "PAGE_THEME_FONT_FAMILY_GEORGIA",
        "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
        "fontSize": 18,
        "italic": false
      },
      "canvasColor": {
        "colors": [
          "#1F3A5F",
          "#F4EDE4"
        ],
        "direction": "135deg",
        "stops": [
          "0%",
          "100%"
        ],
        "type": "THEME_COLOR_TYPE_LINEAR"
      },
      "canvasCoverId": "5f1c2d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f",
      "canvasCoverMode": "PAGE_THEME_BACKGROUND_COVER_MODE_PROGRESSIVE_TOP",
      "containerConfig": {
        "backgroundColor": {
          "colors": [
            "#1F3A5F",
            "#F4EDE4"
          ],
          "direction": "135deg",
          "stops": [
            "0%",
            "100%"
          ],
          "type": "THEME_COLOR_TYPE_LINEAR"
        },
        "borderColor": {
          "colors": [
            "#1F3A5F",
            "#F4EDE4"
          ],
          "direction": "135deg",
          "stops": [
            "0%",
            "100%"
          ],
          "type": "THEME_COLOR_TYPE_LINEAR"
        },
        "borderSize": 2,
        "borderStyle": "PAGE_THEME_BORDER_STYLE_SOLID",
        "opacity": 90,
        "variant": "PAGE_THEME_CONTAINER_VARIANT_ROUNDED"
      },
      "containerEnabled": true,
      "createdAt": "2026-03-14T09:30:00Z",
      "elementColor": {
        "colors": [
          "#1F3A5F",
          "#F4EDE4"
        ],
        "direction": "135deg",
        "stops": [
          "0%",
          "100%"
        ],
        "type": "THEME_COLOR_TYPE_LINEAR"
      },
      "elementFont": {
        "bold": true,
        "color": {
          "colors": [
            "#1F3A5F",
            "#F4EDE4"
          ],
          "direction": "135deg",
          "stops": [
            "0%",
            "100%"
          ],
          "type": "THEME_COLOR_TYPE_LINEAR"
        },
        "family": "PAGE_THEME_FONT_FAMILY_GEORGIA",
        "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
        "fontSize": 18,
        "italic": false
      },
      "footerLogoEnabled": true,
      "footerLogoId": "c3f7a9e1-6d2b-4a8c-b1e5-7d0f3a9c2e64",
      "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "titleFont": {
        "bold": true,
        "color": {
          "colors": [
            "#1F3A5F",
            "#F4EDE4"
          ],
          "direction": "135deg",
          "stops": [
            "0%",
            "100%"
          ],
          "type": "THEME_COLOR_TYPE_LINEAR"
        },
        "family": "PAGE_THEME_FONT_FAMILY_GEORGIA",
        "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
        "fontSize": 18,
        "italic": false
      },
      "updatedAt": "2026-03-18T16:05:00Z",
      "visitorExperience": "PAGE_THEME_VISITOR_EXPERIENCE_CLASSIC",
      "workspaceId": "c0d3cafe-5b1e-4d42-a6fd-0c5f5c3962d0"
    },
    "pageThemeId": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
    "publishedAt": "2026-03-20T10:00:00Z",
    "slug": "lumiere-spring",
    "tags": "restaurant,spring-2026",
    "thumbnailPendingUpdateSince": "2026-03-18T16:05:00Z",
    "thumbnailSignedUrl": "https://cdn.linkbreakers.com/page-theme-templates/0d7f4d9c/thumbnail.png?Expires=1774108800&Signature=b7Xk2pQz9LmN4vR8",
    "updatedAt": "2026-03-18T16:05:00Z",
    "usageCount": 42,
    "workspaceId": "c0d3cafe-5b1e-4d42-a6fd-0c5f5c3962d0"
  }
}
```

### Parameters

`Idempotency-Key` string 

header

A unique value per request, such as a UUID, that makes retrying it safe: a retry with the same key and body returns the first response instead of acting twice.

### Request body

`slug` string

The slug of the public page theme template to import into your workspace

### Response

200

`pageThemeTemplate` object

The imported page theme template (now owned by the importing workspace)

Fields: [The page theme template object](#page-theme-templates-object).

Errors answer 4xx or 5xx with the [error object](https://linkbreakers.com/help/api#errors), and `429` past the [rate limit](https://linkbreakers.com/help/api#rate-limits).

Request

```bash
curl -X POST "https://api.linkbreakers.com/v1/page-theme-templates/import" \
  -H "Authorization: Bearer $LINKBREAKERS_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{
  "slug": "midnight-glass"
}'
```

Response 200

```json
{
  "pageThemeTemplate": {
    "badgeSignedUrl": "https://cdn.linkbreakers.com/media/5f1c2d3e/lumiere-badge.png?Expires=1774108800&Signature=b7Xk2pQz9LmN4vR8",
    "builtIn": false,
    "coverSignedUrl": "https://cdn.linkbreakers.com/media/5f1c2d3e/menu-cover.png?Expires=1774108800&Signature=b7Xk2pQz9LmN4vR8",
    "createdAt": "2026-03-14T09:30:00Z",
    "description": "A warm cream page with navy buttons, made for restaurant menus.",
    "duplicatedFrom": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
    "faq": "[{\"id\": \"1\", \"question\": \"Does it work on a phone?\", \"answer\": \"Yes, every page using this template is built for small screens first.\", \"order\": 1}]",
    "footerLogoSignedUrl": "https://cdn.linkbreakers.com/media/5f1c2d3e/lumiere-logo.png?Expires=1774108800&Signature=b7Xk2pQz9LmN4vR8",
    "id": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
    "learnMore": "## Spring menu\n\nWarm cream background, navy buttons and the Inter font, made for restaurant table cards.",
    "name": "Lumiere Spring",
    "owned": true,
    "pageTheme": {
      "badgeEnabled": true,
      "badgeIconColor": {
        "colors": [
          "#1F3A5F",
          "#F4EDE4"
        ],
        "direction": "135deg",
        "stops": [
          "0%",
          "100%"
        ],
        "type": "THEME_COLOR_TYPE_LINEAR"
      },
      "badgeId": "8e4a1c7d-2b9f-4d3e-a5c6-9f0b1e7d3a52",
      "badgeShape": "PAGE_THEME_BADGE_SHAPE_CIRCLE",
      "bodyFont": {
        "bold": true,
        "color": {
          "colors": [
            "#1F3A5F",
            "#F4EDE4"
          ],
          "direction": "135deg",
          "stops": [
            "0%",
            "100%"
          ],
          "type": "THEME_COLOR_TYPE_LINEAR"
        },
        "family": "PAGE_THEME_FONT_FAMILY_GEORGIA",
        "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
        "fontSize": 18,
        "italic": false
      },
      "canvasColor": {
        "colors": [
          "#1F3A5F",
          "#F4EDE4"
        ],
        "direction": "135deg",
        "stops": [
          "0%",
          "100%"
        ],
        "type": "THEME_COLOR_TYPE_LINEAR"
      },
      "canvasCoverId": "5f1c2d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f",
      "canvasCoverMode": "PAGE_THEME_BACKGROUND_COVER_MODE_PROGRESSIVE_TOP",
      "containerConfig": {
        "backgroundColor": {
          "colors": [
            "#1F3A5F",
            "#F4EDE4"
          ],
          "direction": "135deg",
          "stops": [
            "0%",
            "100%"
          ],
          "type": "THEME_COLOR_TYPE_LINEAR"
        },
        "borderColor": {
          "colors": [
            "#1F3A5F",
            "#F4EDE4"
          ],
          "direction": "135deg",
          "stops": [
            "0%",
            "100%"
          ],
          "type": "THEME_COLOR_TYPE_LINEAR"
        },
        "borderSize": 2,
        "borderStyle": "PAGE_THEME_BORDER_STYLE_SOLID",
        "opacity": 90,
        "variant": "PAGE_THEME_CONTAINER_VARIANT_ROUNDED"
      },
      "containerEnabled": true,
      "createdAt": "2026-03-14T09:30:00Z",
      "elementColor": {
        "colors": [
          "#1F3A5F",
          "#F4EDE4"
        ],
        "direction": "135deg",
        "stops": [
          "0%",
          "100%"
        ],
        "type": "THEME_COLOR_TYPE_LINEAR"
      },
      "elementFont": {
        "bold": true,
        "color": {
          "colors": [
            "#1F3A5F",
            "#F4EDE4"
          ],
          "direction": "135deg",
          "stops": [
            "0%",
            "100%"
          ],
          "type": "THEME_COLOR_TYPE_LINEAR"
        },
        "family": "PAGE_THEME_FONT_FAMILY_GEORGIA",
        "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
        "fontSize": 18,
        "italic": false
      },
      "footerLogoEnabled": true,
      "footerLogoId": "c3f7a9e1-6d2b-4a8c-b1e5-7d0f3a9c2e64",
      "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "titleFont": {
        "bold": true,
        "color": {
          "colors": [
            "#1F3A5F",
            "#F4EDE4"
          ],
          "direction": "135deg",
          "stops": [
            "0%",
            "100%"
          ],
          "type": "THEME_COLOR_TYPE_LINEAR"
        },
        "family": "PAGE_THEME_FONT_FAMILY_GEORGIA",
        "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
        "fontSize": 18,
        "italic": false
      },
      "updatedAt": "2026-03-18T16:05:00Z",
      "visitorExperience": "PAGE_THEME_VISITOR_EXPERIENCE_CLASSIC",
      "workspaceId": "c0d3cafe-5b1e-4d42-a6fd-0c5f5c3962d0"
    },
    "pageThemeId": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
    "publishedAt": "2026-03-20T10:00:00Z",
    "slug": "lumiere-spring",
    "tags": "restaurant,spring-2026",
    "thumbnailPendingUpdateSince": "2026-03-18T16:05:00Z",
    "thumbnailSignedUrl": "https://cdn.linkbreakers.com/page-theme-templates/0d7f4d9c/thumbnail.png?Expires=1774108800&Signature=b7Xk2pQz9LmN4vR8",
    "updatedAt": "2026-03-18T16:05:00Z",
    "usageCount": 42,
    "workspaceId": "c0d3cafe-5b1e-4d42-a6fd-0c5f5c3962d0"
  }
}
```

### Parameters

`id` string 

path

Required

The ID of the page theme template to update (UUID)

`Idempotency-Key` string 

header

A unique value per request, such as a UUID, that makes retrying it safe: a retry with the same key and body returns the first response instead of acting twice.

### Request body

`description` string

The new description of the page theme template

`faq` string

FAQ data to update (JSON string)

`learnMore` string

Extended markdown-supported content for "learn more" section

`name` string

The new name of the page theme template

`slug` string

The new slug for the page theme template (must be unique globally)

`tags` string

The new tags for the page theme template (comma-separated)

### Response

200

`pageThemeTemplate` object

The updated page theme template

Fields: [The page theme template object](#page-theme-templates-object).

Errors answer 4xx or 5xx with the [error object](https://linkbreakers.com/help/api#errors), and `429` past the [rate limit](https://linkbreakers.com/help/api#rate-limits).

Request

```bash
curl -X PATCH "https://api.linkbreakers.com/v1/page-theme-templates/{id}" \
  -H "Authorization: Bearer $LINKBREAKERS_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{
  "description": "A warm cream page with navy buttons, made for restaurant menus.",
  "faq": "[{\"id\": \"1\", \"question\": \"Does it work on a phone?\", \"answer\": \"Yes, every page using this template is built for small screens first.\", \"order\": 1}]",
  "learnMore": "## Spring menu\n\nWarm cream background, navy buttons and the Inter font, made for restaurant table cards.",
  "name": "Lumiere Summer",
  "slug": "lumiere-summer",
  "tags": "restaurant,spring-2026"
}'
```

Response 200

```json
{
  "pageThemeTemplate": {
    "badgeSignedUrl": "https://cdn.linkbreakers.com/media/5f1c2d3e/lumiere-badge.png?Expires=1774108800&Signature=b7Xk2pQz9LmN4vR8",
    "builtIn": false,
    "coverSignedUrl": "https://cdn.linkbreakers.com/media/5f1c2d3e/menu-cover.png?Expires=1774108800&Signature=b7Xk2pQz9LmN4vR8",
    "createdAt": "2026-03-14T09:30:00Z",
    "description": "A warm cream page with navy buttons, made for restaurant menus.",
    "duplicatedFrom": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
    "faq": "[{\"id\": \"1\", \"question\": \"Does it work on a phone?\", \"answer\": \"Yes, every page using this template is built for small screens first.\", \"order\": 1}]",
    "footerLogoSignedUrl": "https://cdn.linkbreakers.com/media/5f1c2d3e/lumiere-logo.png?Expires=1774108800&Signature=b7Xk2pQz9LmN4vR8",
    "id": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
    "learnMore": "## Spring menu\n\nWarm cream background, navy buttons and the Inter font, made for restaurant table cards.",
    "name": "Lumiere Spring",
    "owned": true,
    "pageTheme": {
      "badgeEnabled": true,
      "badgeIconColor": {
        "colors": [
          "#1F3A5F",
          "#F4EDE4"
        ],
        "direction": "135deg",
        "stops": [
          "0%",
          "100%"
        ],
        "type": "THEME_COLOR_TYPE_LINEAR"
      },
      "badgeId": "8e4a1c7d-2b9f-4d3e-a5c6-9f0b1e7d3a52",
      "badgeShape": "PAGE_THEME_BADGE_SHAPE_CIRCLE",
      "bodyFont": {
        "bold": true,
        "color": {
          "colors": [
            "#1F3A5F",
            "#F4EDE4"
          ],
          "direction": "135deg",
          "stops": [
            "0%",
            "100%"
          ],
          "type": "THEME_COLOR_TYPE_LINEAR"
        },
        "family": "PAGE_THEME_FONT_FAMILY_GEORGIA",
        "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
        "fontSize": 18,
        "italic": false
      },
      "canvasColor": {
        "colors": [
          "#1F3A5F",
          "#F4EDE4"
        ],
        "direction": "135deg",
        "stops": [
          "0%",
          "100%"
        ],
        "type": "THEME_COLOR_TYPE_LINEAR"
      },
      "canvasCoverId": "5f1c2d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f",
      "canvasCoverMode": "PAGE_THEME_BACKGROUND_COVER_MODE_PROGRESSIVE_TOP",
      "containerConfig": {
        "backgroundColor": {
          "colors": [
            "#1F3A5F",
            "#F4EDE4"
          ],
          "direction": "135deg",
          "stops": [
            "0%",
            "100%"
          ],
          "type": "THEME_COLOR_TYPE_LINEAR"
        },
        "borderColor": {
          "colors": [
            "#1F3A5F",
            "#F4EDE4"
          ],
          "direction": "135deg",
          "stops": [
            "0%",
            "100%"
          ],
          "type": "THEME_COLOR_TYPE_LINEAR"
        },
        "borderSize": 2,
        "borderStyle": "PAGE_THEME_BORDER_STYLE_SOLID",
        "opacity": 90,
        "variant": "PAGE_THEME_CONTAINER_VARIANT_ROUNDED"
      },
      "containerEnabled": true,
      "createdAt": "2026-03-14T09:30:00Z",
      "elementColor": {
        "colors": [
          "#1F3A5F",
          "#F4EDE4"
        ],
        "direction": "135deg",
        "stops": [
          "0%",
          "100%"
        ],
        "type": "THEME_COLOR_TYPE_LINEAR"
      },
      "elementFont": {
        "bold": true,
        "color": {
          "colors": [
            "#1F3A5F",
            "#F4EDE4"
          ],
          "direction": "135deg",
          "stops": [
            "0%",
            "100%"
          ],
          "type": "THEME_COLOR_TYPE_LINEAR"
        },
        "family": "PAGE_THEME_FONT_FAMILY_GEORGIA",
        "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
        "fontSize": 18,
        "italic": false
      },
      "footerLogoEnabled": true,
      "footerLogoId": "c3f7a9e1-6d2b-4a8c-b1e5-7d0f3a9c2e64",
      "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "titleFont": {
        "bold": true,
        "color": {
          "colors": [
            "#1F3A5F",
            "#F4EDE4"
          ],
          "direction": "135deg",
          "stops": [
            "0%",
            "100%"
          ],
          "type": "THEME_COLOR_TYPE_LINEAR"
        },
        "family": "PAGE_THEME_FONT_FAMILY_GEORGIA",
        "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
        "fontSize": 18,
        "italic": false
      },
      "updatedAt": "2026-03-18T16:05:00Z",
      "visitorExperience": "PAGE_THEME_VISITOR_EXPERIENCE_CLASSIC",
      "workspaceId": "c0d3cafe-5b1e-4d42-a6fd-0c5f5c3962d0"
    },
    "pageThemeId": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
    "publishedAt": "2026-03-20T10:00:00Z",
    "slug": "lumiere-spring",
    "tags": "restaurant,spring-2026",
    "thumbnailPendingUpdateSince": "2026-03-18T16:05:00Z",
    "thumbnailSignedUrl": "https://cdn.linkbreakers.com/page-theme-templates/0d7f4d9c/thumbnail.png?Expires=1774108800&Signature=b7Xk2pQz9LmN4vR8",
    "updatedAt": "2026-03-18T16:05:00Z",
    "usageCount": 42,
    "workspaceId": "c0d3cafe-5b1e-4d42-a6fd-0c5f5c3962d0"
  }
}
```

### Parameters

`id` string 

path

Required

The ID of the page theme template whose styling to update (UUID)

`Idempotency-Key` string 

header

A unique value per request, such as a UUID, that makes retrying it safe: a retry with the same key and body returns the first response instead of acting twice.

### Request body

`badge` object

Picks an image from the workspace's media library, or removes it. Any ready image of at most 3 MB can be a background cover, badge or footer logo, wherever it was uploaded from; anything else is refused with MEDIA\_NOT\_ALLOWED\_HERE, whose metadata names the slot, the reason (KIND\_NOT\_ACCEPTED or TOO\_LARGE) and the limit.

2 child attributes

`delete` object

`id` string

`badgeEnabled` boolean

\--- Badge Section ---

`badgeIconColor` object

A color used across the design APIs (page themes, QR code designs). Solid or gradient, with an optional direction and per-stop offsets.

4 child attributes

`colors` array of string 

Required

Color values in render order (hex, rgb/rgba, hsl/hsla).

`direction` string

Optional direction for linear gradients (e.g. "135deg", "to right").

`stops` array of string

Optional stop offsets aligned with `colors` (e.g. "0%", "50%", "100%").

`type` enum 

Required

Color type

Allowed values

* `THEME_COLOR_TYPE_SOLID`
* `THEME_COLOR_TYPE_LINEAR`
* `THEME_COLOR_TYPE_RADIAL`

`badgeShape` enum

Allowed values

* `PAGE_THEME_BADGE_SHAPE_CIRCLE`
* `PAGE_THEME_BADGE_SHAPE_SQUARE`
* `PAGE_THEME_BADGE_SHAPE_ROUNDED`

`bodyFont` object

Font configuration with family, styling, and color

6 child attributes, the same as [pageTheme.bodyFont in the page theme template object](#page-theme-templates-object-pagetheme-bodyfont).

`canvasColor` object

\--- Background Section ---

4 child attributes

`colors` array of string 

Required

Color values in render order (hex, rgb/rgba, hsl/hsla).

`direction` string

Optional direction for linear gradients (e.g. "135deg", "to right").

`stops` array of string

Optional stop offsets aligned with `colors` (e.g. "0%", "50%", "100%").

`type` enum 

Required

Color type

Allowed values

* `THEME_COLOR_TYPE_SOLID`
* `THEME_COLOR_TYPE_LINEAR`
* `THEME_COLOR_TYPE_RADIAL`

`canvasCover` object

Picks an image from the workspace's media library, or removes it. Any ready image of at most 3 MB can be a background cover, badge or footer logo, wherever it was uploaded from; anything else is refused with MEDIA\_NOT\_ALLOWED\_HERE, whose metadata names the slot, the reason (KIND\_NOT\_ACCEPTED or TOO\_LARGE) and the limit.

2 child attributes

`delete` object

`id` string

`canvasCoverMode` enum

Allowed values

* `PAGE_THEME_BACKGROUND_COVER_MODE_FULL`
* `PAGE_THEME_BACKGROUND_COVER_MODE_PROGRESSIVE_TOP`
* `PAGE_THEME_BACKGROUND_COVER_MODE_PROGRESSIVE_BOTTOM`

`containerConfig` object

Container styling configuration

6 child attributes, the same as [pageTheme.containerConfig in the page theme template object](#page-theme-templates-object-pagetheme-containerconfig).

`containerEnabled` boolean

`elementColor` object

A color used across the design APIs (page themes, QR code designs). Solid or gradient, with an optional direction and per-stop offsets.

4 child attributes

`colors` array of string 

Required

Color values in render order (hex, rgb/rgba, hsl/hsla).

`direction` string

Optional direction for linear gradients (e.g. "135deg", "to right").

`stops` array of string

Optional stop offsets aligned with `colors` (e.g. "0%", "50%", "100%").

`type` enum 

Required

Color type

Allowed values

* `THEME_COLOR_TYPE_SOLID`
* `THEME_COLOR_TYPE_LINEAR`
* `THEME_COLOR_TYPE_RADIAL`

`elementFont` object

Font configuration with family, styling, and color

6 child attributes, the same as [pageTheme.bodyFont in the page theme template object](#page-theme-templates-object-pagetheme-bodyfont).

`footerLogo` object

Picks an image from the workspace's media library, or removes it. Any ready image of at most 3 MB can be a background cover, badge or footer logo, wherever it was uploaded from; anything else is refused with MEDIA\_NOT\_ALLOWED\_HERE, whose metadata names the slot, the reason (KIND\_NOT\_ACCEPTED or TOO\_LARGE) and the limit.

2 child attributes

`delete` object

`id` string

`footerLogoEnabled` boolean

Small company or brand logo centered at the bottom of every page using the theme.

`titleFont` object

\--- Typography Section ---

6 child attributes, the same as [pageTheme.bodyFont in the page theme template object](#page-theme-templates-object-pagetheme-bodyfont).

`visitorExperience` enum

How visitor pages pace their content: CLASSIC shows a whole form at once, FOCUSED one question per screen.

Allowed values

* `PAGE_THEME_VISITOR_EXPERIENCE_CLASSIC`
* `PAGE_THEME_VISITOR_EXPERIENCE_FOCUSED`

### Response

200

`pageThemeTemplate` object

Reusable page styling presets that help teams give every link page a consistent look.

Fields: [The page theme template object](#page-theme-templates-object).

Errors answer 4xx or 5xx with the [error object](https://linkbreakers.com/help/api#errors), and `429` past the [rate limit](https://linkbreakers.com/help/api#rate-limits).

Request

```bash
curl -X PATCH "https://api.linkbreakers.com/v1/page-theme-templates/{id}/styling" \
  -H "Authorization: Bearer $LINKBREAKERS_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{
  "badge": {
    "delete": {},
    "id": "5f1c2d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f"
  },
  "badgeEnabled": true,
  "badgeIconColor": {
    "colors": [
      "#1F3A5F",
      "#F4EDE4"
    ],
    "direction": "135deg",
    "stops": [
      "0%",
      "100%"
    ],
    "type": "THEME_COLOR_TYPE_LINEAR"
  },
  "badgeShape": "PAGE_THEME_BADGE_SHAPE_CIRCLE",
  "bodyFont": {
    "bold": true,
    "color": {
      "colors": [
        "#1F3A5F",
        "#F4EDE4"
      ],
      "direction": "135deg",
      "stops": [
        "0%",
        "100%"
      ],
      "type": "THEME_COLOR_TYPE_LINEAR"
    },
    "family": "PAGE_THEME_FONT_FAMILY_GEORGIA",
    "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
    "fontSize": 18,
    "italic": false
  },
  "canvasColor": {
    "colors": [
      "#1F3A5F",
      "#F4EDE4"
    ],
    "direction": "135deg",
    "stops": [
      "0%",
      "100%"
    ],
    "type": "THEME_COLOR_TYPE_LINEAR"
  },
  "canvasCover": {
    "delete": {},
    "id": "5f1c2d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f"
  },
  "canvasCoverMode": "PAGE_THEME_BACKGROUND_COVER_MODE_PROGRESSIVE_TOP",
  "containerConfig": {
    "backgroundColor": {
      "colors": [
        "#1F3A5F",
        "#F4EDE4"
      ],
      "direction": "135deg",
      "stops": [
        "0%",
        "100%"
      ],
      "type": "THEME_COLOR_TYPE_LINEAR"
    },
    "borderColor": {
      "colors": [
        "#1F3A5F",
        "#F4EDE4"
      ],
      "direction": "135deg",
      "stops": [
        "0%",
        "100%"
      ],
      "type": "THEME_COLOR_TYPE_LINEAR"
    },
    "borderSize": 2,
    "borderStyle": "PAGE_THEME_BORDER_STYLE_SOLID",
    "opacity": 90,
    "variant": "PAGE_THEME_CONTAINER_VARIANT_ROUNDED"
  },
  "containerEnabled": true,
  "elementColor": {
    "colors": [
      "#1F3A5F",
      "#F4EDE4"
    ],
    "direction": "135deg",
    "stops": [
      "0%",
      "100%"
    ],
    "type": "THEME_COLOR_TYPE_LINEAR"
  },
  "elementFont": {
    "bold": true,
    "color": {
      "colors": [
        "#1F3A5F",
        "#F4EDE4"
      ],
      "direction": "135deg",
      "stops": [
        "0%",
        "100%"
      ],
      "type": "THEME_COLOR_TYPE_LINEAR"
    },
    "family": "PAGE_THEME_FONT_FAMILY_GEORGIA",
    "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
    "fontSize": 18,
    "italic": false
  },
  "footerLogo": {
    "delete": {},
    "id": "5f1c2d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f"
  },
  "footerLogoEnabled": true,
  "titleFont": {
    "bold": true,
    "color": {
      "colors": [
        "#1F3A5F",
        "#F4EDE4"
      ],
      "direction": "135deg",
      "stops": [
        "0%",
        "100%"
      ],
      "type": "THEME_COLOR_TYPE_LINEAR"
    },
    "family": "PAGE_THEME_FONT_FAMILY_GEORGIA",
    "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
    "fontSize": 18,
    "italic": false
  },
  "visitorExperience": "PAGE_THEME_VISITOR_EXPERIENCE_FOCUSED"
}'
```

Response 200

```json
{
  "pageThemeTemplate": {
    "badgeSignedUrl": "https://cdn.linkbreakers.com/media/5f1c2d3e/lumiere-badge.png?Expires=1774108800&Signature=b7Xk2pQz9LmN4vR8",
    "builtIn": false,
    "coverSignedUrl": "https://cdn.linkbreakers.com/media/5f1c2d3e/menu-cover.png?Expires=1774108800&Signature=b7Xk2pQz9LmN4vR8",
    "createdAt": "2026-03-14T09:30:00Z",
    "description": "A warm cream page with navy buttons, made for restaurant menus.",
    "duplicatedFrom": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
    "faq": "[{\"id\": \"1\", \"question\": \"Does it work on a phone?\", \"answer\": \"Yes, every page using this template is built for small screens first.\", \"order\": 1}]",
    "footerLogoSignedUrl": "https://cdn.linkbreakers.com/media/5f1c2d3e/lumiere-logo.png?Expires=1774108800&Signature=b7Xk2pQz9LmN4vR8",
    "id": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
    "learnMore": "## Spring menu\n\nWarm cream background, navy buttons and the Inter font, made for restaurant table cards.",
    "name": "Lumiere Spring",
    "owned": true,
    "pageTheme": {
      "badgeEnabled": true,
      "badgeIconColor": {
        "colors": [
          "#1F3A5F",
          "#F4EDE4"
        ],
        "direction": "135deg",
        "stops": [
          "0%",
          "100%"
        ],
        "type": "THEME_COLOR_TYPE_LINEAR"
      },
      "badgeId": "8e4a1c7d-2b9f-4d3e-a5c6-9f0b1e7d3a52",
      "badgeShape": "PAGE_THEME_BADGE_SHAPE_CIRCLE",
      "bodyFont": {
        "bold": true,
        "color": {
          "colors": [
            "#1F3A5F",
            "#F4EDE4"
          ],
          "direction": "135deg",
          "stops": [
            "0%",
            "100%"
          ],
          "type": "THEME_COLOR_TYPE_LINEAR"
        },
        "family": "PAGE_THEME_FONT_FAMILY_GEORGIA",
        "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
        "fontSize": 18,
        "italic": false
      },
      "canvasColor": {
        "colors": [
          "#1F3A5F",
          "#F4EDE4"
        ],
        "direction": "135deg",
        "stops": [
          "0%",
          "100%"
        ],
        "type": "THEME_COLOR_TYPE_LINEAR"
      },
      "canvasCoverId": "5f1c2d3e-4b5a-6c7d-8e9f-0a1b2c3d4e5f",
      "canvasCoverMode": "PAGE_THEME_BACKGROUND_COVER_MODE_PROGRESSIVE_TOP",
      "containerConfig": {
        "backgroundColor": {
          "colors": [
            "#1F3A5F",
            "#F4EDE4"
          ],
          "direction": "135deg",
          "stops": [
            "0%",
            "100%"
          ],
          "type": "THEME_COLOR_TYPE_LINEAR"
        },
        "borderColor": {
          "colors": [
            "#1F3A5F",
            "#F4EDE4"
          ],
          "direction": "135deg",
          "stops": [
            "0%",
            "100%"
          ],
          "type": "THEME_COLOR_TYPE_LINEAR"
        },
        "borderSize": 2,
        "borderStyle": "PAGE_THEME_BORDER_STYLE_SOLID",
        "opacity": 90,
        "variant": "PAGE_THEME_CONTAINER_VARIANT_ROUNDED"
      },
      "containerEnabled": true,
      "createdAt": "2026-03-14T09:30:00Z",
      "elementColor": {
        "colors": [
          "#1F3A5F",
          "#F4EDE4"
        ],
        "direction": "135deg",
        "stops": [
          "0%",
          "100%"
        ],
        "type": "THEME_COLOR_TYPE_LINEAR"
      },
      "elementFont": {
        "bold": true,
        "color": {
          "colors": [
            "#1F3A5F",
            "#F4EDE4"
          ],
          "direction": "135deg",
          "stops": [
            "0%",
            "100%"
          ],
          "type": "THEME_COLOR_TYPE_LINEAR"
        },
        "family": "PAGE_THEME_FONT_FAMILY_GEORGIA",
        "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
        "fontSize": 18,
        "italic": false
      },
      "footerLogoEnabled": true,
      "footerLogoId": "c3f7a9e1-6d2b-4a8c-b1e5-7d0f3a9c2e64",
      "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "titleFont": {
        "bold": true,
        "color": {
          "colors": [
            "#1F3A5F",
            "#F4EDE4"
          ],
          "direction": "135deg",
          "stops": [
            "0%",
            "100%"
          ],
          "type": "THEME_COLOR_TYPE_LINEAR"
        },
        "family": "PAGE_THEME_FONT_FAMILY_GEORGIA",
        "familyStack": "\"Gill Sans\", \"Trebuchet MS\", sans-serif",
        "fontSize": 18,
        "italic": false
      },
      "updatedAt": "2026-03-18T16:05:00Z",
      "visitorExperience": "PAGE_THEME_VISITOR_EXPERIENCE_CLASSIC",
      "workspaceId": "c0d3cafe-5b1e-4d42-a6fd-0c5f5c3962d0"
    },
    "pageThemeId": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
    "publishedAt": "2026-03-20T10:00:00Z",
    "slug": "lumiere-spring",
    "tags": "restaurant,spring-2026",
    "thumbnailPendingUpdateSince": "2026-03-18T16:05:00Z",
    "thumbnailSignedUrl": "https://cdn.linkbreakers.com/page-theme-templates/0d7f4d9c/thumbnail.png?Expires=1774108800&Signature=b7Xk2pQz9LmN4vR8",
    "updatedAt": "2026-03-18T16:05:00Z",
    "usageCount": 42,
    "workspaceId": "c0d3cafe-5b1e-4d42-a6fd-0c5f5c3962d0"
  }
}
```

### Parameters

`id` string 

path

Required

### Response

200

An empty JSON object.

Errors answer 4xx or 5xx with the [error object](https://linkbreakers.com/help/api#errors), and `429` past the [rate limit](https://linkbreakers.com/help/api#rate-limits).

Request

```bash
curl -X DELETE "https://api.linkbreakers.com/v1/page-theme-templates/{id}" \
  -H "Authorization: Bearer $LINKBREAKERS_TOKEN"
```

---

Source: https://linkbreakers.com/help/api/page-theme-templates
