---
title: "Page Themes API Reference | Linkbreakers"
description: "The look of a link's pages (colors, fonts, cover, badge, buttons): read and update one link's theme, or restyle many links at once."
canonical: "https://linkbreakers.com/help/api/page-themes"
---

# Page Themes

The look of a link's pages (colors, fonts, cover, badge, buttons): read and update one link's theme, or restyle many links at once.

6 entries on this page

## The page theme object

Page theme configuration

`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 [bodyFont in the page theme object](#page-themes-object-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 [bodyFont in the page theme object](#page-themes-object-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

Example page theme

```json
{
  "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"
}
```

### Parameters

`pageSize` integer (int64) 

query

Maximum number of page themes to return. Defaults to 100, capped at 1000.

`pageToken` string 

query

Cursor from a previous response's nextPageToken. Empty starts at the first page. Pages are ordered by (createdAt, id), which never change, so a record cannot move between pages while a client is walking them.

`cursor` string 

query

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

### Response

200

`nextPageToken` string

Cursor to continue listing page themes. Empty on the last page.

`pageThemes` array of object

List of page themes

Fields: [The page theme object](#page-themes-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-themes" \
  -H "Authorization: Bearer $LINKBREAKERS_TOKEN"
```

Response 200

```json
{
  "nextPageToken": "eyJpZCI6ImY0N2FjMTBiIn0=",
  "pageThemes": [
    {
      "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"
    }
  ],
  "totalCount": 24
}
```

### Parameters

`id` string 

path

Required

Page theme ID to retrieve

### Response

200

`pageTheme` object

The page theme

Fields: [The page theme object](#page-themes-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-themes/{id}" \
  -H "Authorization: Bearer $LINKBREAKERS_TOKEN"
```

Response 200

```json
{
  "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"
  }
}
```

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

`linkId` string 

Required

Link whose page theme should be restyled

`pageThemeTemplateId` string

Template to apply, addressed by ID. Use this for workspace templates that have not been published and therefore have no slug.

`slug` string

Slug of the page theme template to apply.

Only published and built-in templates carry a slug: it is the public identifier the gallery and the marketing site address them by. Supply pageThemeTemplateId instead for a workspace's own drafts, which have none. Exactly one of the two is required.

### Response

200

`pageTheme` object

The link's page theme, with the template's styling applied

Fields: [The page theme object](#page-themes-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-themes/apply-template" \
  -H "Authorization: Bearer $LINKBREAKERS_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{
  "linkId": "1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed",
  "pageThemeTemplateId": "0d7f4d9c-1aef-4ed4-821b-321a3f9cba1d",
  "slug": "midnight-glass"
}'
```

Response 200

```json
{
  "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"
  }
}
```

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

`changes` array of object 

Required

The changes. One entry for the same look on every link; a link named in a later entry gets that entry instead of the earlier one. Up to 50 distinct links in all.

4 child attributes

`links` array of string 

Required

The links, each named by id or short link.

`pageThemeTemplateId` string

ID of the page theme template to apply, for a template without a slug. Ignored when slug is set.

`slug` string

Slug of the page theme template to apply.

`theme` object

Values to set.

16 child attributes

`badge` object

Any image of at most 3 MB from the media library

2 child attributes

`delete` object

`id` string

`badgeEnabled` boolean

`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

`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

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`

`canvasCover` object

Any image of at most 3 MB from the media library

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

`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

False clears containerConfig

`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

`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

`footerLogo` object

Any image of at most 3 MB from the media library

2 child attributes

`delete` object

`id` string

`footerLogoEnabled` boolean

A small logo at the bottom of every page using this theme

`titleFont` object

Font configuration with family, styling, and color

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

`visitorExperience` enum

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

`failedCount` integer (int32)

`results` array of object

6 child attributes

`errorCode` string

Why it failed, for a failed link.

`errorMessage` string

`link` string

The link as the request named it.

`linkId` string

The link's id. Empty when the name matched no link of this workspace.

`pageThemeId` string

The link's page theme, for a link that succeeded.

`status` enum

How a bulk edit went on one link.

Allowed values

* `BULK_EDIT_STATUS_SUCCEEDED` The change is saved.
* `BULK_EDIT_STATUS_FAILED` It failed: errorCode and errorMessage say why.

`succeededCount` integer (int32)

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-themes/bulk-update" \
  -H "Authorization: Bearer $LINKBREAKERS_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{
  "changes": [
    {
      "links": [
        "linkbreak.ing/4BnH-R19p",
        "6e2b7f40-3c1a-4d8e-9b25-7a0f1c3d5e82"
      ],
      "pageThemeTemplateId": "2b8d4f60-7a1c-4e3b-9f52-c6d0e8a1b347",
      "slug": "midnight-glass",
      "theme": {
        "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
{
  "failedCount": 1,
  "results": [
    {
      "errorCode": "LINK_NOT_FOUND",
      "errorMessage": "No link of this workspace is named linkbreak.ing/old-menu.",
      "link": "linkbreak.ing/4BnH-R19p",
      "linkId": "1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed",
      "pageThemeId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "status": "BULK_EDIT_STATUS_SUCCEEDED"
    }
  ],
  "succeededCount": 2
}
```

### Parameters

`id` string 

path

Required

Page theme ID to update

`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

Badge media selection to update: any image of at most 3 MB from the media library

2 child attributes

`delete` object

`id` string

`badgeEnabled` boolean

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

`badgeIconColor` object

Badge icon background color to update

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

Badge shape to update

Allowed values

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

`bodyFont` object

Body font configuration to update

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

`canvasColor` object

\--- Background Section --- Canvas color configuration to update

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

Cover media selection to update: any image of at most 3 MB from the media library

2 child attributes

`delete` object

`id` string

`canvasCoverMode` enum

Cover display mode to update

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 to update

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

`containerEnabled` boolean

Whether container is enabled (false clears containerConfig)

`elementColor` object

Interactive element background color configuration to update

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 to update

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

`footerLogo` object

Footer logo media selection: id of any image of at most 3 MB from the workspace's media library, or delete to remove the image.

2 child attributes

`delete` object

`id` string

`footerLogoEnabled` boolean

Whether to show the footer logo, a small company or brand logo centered at the bottom of every page using this theme (false hides it but keeps the image).

`titleFont` object

\--- Typography Section --- Title font configuration to update

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

`visitorExperience` enum

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

Allowed values

* `PAGE_THEME_VISITOR_EXPERIENCE_CLASSIC`
* `PAGE_THEME_VISITOR_EXPERIENCE_FOCUSED`

### Response

200

`pageTheme` object

The updated page theme

Fields: [The page theme object](#page-themes-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-themes/{id}" \
  -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
{
  "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"
  }
}
```

---

Source: https://linkbreakers.com/help/api/page-themes
