---
title: "QR Code Designs API Reference"
description: "Endpoints for managing QR Code Designs in Linkbreakers. These endpoints allow you to create, retrieve, update, and delete QR Code Designs."
canonical: "https://linkbreakers.com/help/api/qr-code-designs"
---

# QR Code Designs

Endpoints for managing QR Code Designs in Linkbreakers. These endpoints allow you to create, retrieve, update, and delete QR Code Designs.

## QR Code Designs

## [#](#qr-code-designs-object)The QR Code Design object

Captures the visual recipe Linkbreakers uses when rendering downloadable QR codes, including colors, shapes, export options, and center media. QR Code Designs are the visual representation of a link. They can be attached to QR Code Templates for reusability. They can only be attached to one record at a time.

backgroundOptions

object

BackgroundOptions represents the styling options for the QR code background

centralImageMargin

integer (int32)

The margin around the central image in pixels

centralImageSignedUrl

string

The signed URL for the central image This URL eventually expires

centralImageSize

number (double)

The size of the central image relative to the QR code (0.0-1.0 proportion)

cornersDotOptions

object

CornersDotOptions represents the styling options for the dot corners in the QR code

cornersSquareOptions

object

CornersSquareOptions represents the styling options for the square corners in the QR code

createdAt

string (date-time)

When the QR code design was created

dotsOptions

object

DotsOptions represents the styling options for the dots in the QR code

errorCorrectionLevel

string

Error correction level forwarded to the QR renderer ("L","M","Q","H")

height

integer (int32)

Export height in pixels

hideBackgroundDots

boolean

Whether to remove dots behind the central image to improve contrast

id

string

The unique identifier of the QR code design (UUID)

outputFileFormat

string (enum)

The output file format for the QR code

##### Allowed values

`OUTPUT_FILE_FORMAT_UNSPECIFIED`

Output format not specified (defaults to PNG server-side)

`OUTPUT_FILE_FORMAT_SVG`

Scalable Vector Graphics format for infinite resolution

`OUTPUT_FILE_FORMAT_PNG`

Portable Network Graphics format with transparency support

`OUTPUT_FILE_FORMAT_JPEG`

Joint Photographic Experts Group format for compressed images

`OUTPUT_FILE_FORMAT_WEBP`

WebP format for modern web-optimized compression

shape

string (enum)

The shape of the QR code

##### Allowed values

`SHAPE_UNSPECIFIED`

Shape not specified (defaults to square modules)

`SHAPE_SQUARE`

Traditional square modules for QR code data points

`SHAPE_CIRCLE`

Circular modules for a rounded visual appearance

updatedAt

string (date-time)

When the QR code design was last updated

width

integer (int32)

Export width in pixels

[Learn moreLearn more about QR code designs in Linkbreakers](https://linkbreakers.com/help/article/whats-a-qr-code-design)

Example object

```json
{
  "backgroundOptions": {
    "themeColor": {
      "colors": [
        "string"
      ],
      "direction": "string",
      "stops": [
        "string"
      ],
      "type": "THEME_COLOR_TYPE_UNSPECIFIED"
    }
  },
  "centralImageMargin": 0,
  "centralImageSignedUrl": "https://example.com",
  "centralImageSize": 0,
  "cornersDotOptions": {
    "themeColor": {
      "colors": [
        "string"
      ],
      "direction": "string",
      "stops": [
        "string"
      ],
      "type": "THEME_COLOR_TYPE_UNSPECIFIED"
    },
    "type": "CORNERS_DOT_TYPE_UNSPECIFIED"
  },
  "cornersSquareOptions": {
    "themeColor": {
      "colors": [
        "string"
      ],
      "direction": "string",
      "stops": [
        "string"
      ],
      "type": "THEME_COLOR_TYPE_UNSPECIFIED"
    },
    "type": "CORNERS_SQUARE_TYPE_UNSPECIFIED"
  },
  "createdAt": "2026-10-13T03:21:20.080Z",
  "dotsOptions": {
    "themeColor": {
      "colors": [
        "string"
      ],
      "direction": "string",
      "stops": [
        "string"
      ],
      "type": "THEME_COLOR_TYPE_UNSPECIFIED"
    },
    "type": "DOTS_TYPE_UNSPECIFIED"
  },
  "errorCorrectionLevel": "string",
  "height": 0,
  "hideBackgroundDots": false,
  "id": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
  "outputFileFormat": "OUTPUT_FILE_FORMAT_PNG",
  "shape": "SHAPE_SQUARE",
  "updatedAt": "2026-10-13T03:21:20.080Z",
  "width": 0
}
```

GET

`/v1/qrcode-designs/{id}`

Requires auth

## [#](#get-a-qr-code-design)Get a QR code design

Fetch a QR code design by its identifier including computed metadata. Requires the \`qrcodes:read\` scope.

### [#](#get-a-qr-code-design-parameters)Parameters

#### path parameters

id

string

Required

path

The ID of the QR code design to get (UUID)

### [#](#get-a-qr-code-design-response)Response

200

Everything worked as expected.

qrcodeDesign

object

Captures the visual recipe Linkbreakers uses when rendering downloadable QR codes, including colors, shapes, export options, and center media. QR Code Designs are the visual representation of a link. They can be attached to QR Code Templates for reusability. They can only be attached to one record at a time.

### [#](#get-a-qr-code-design-error)Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

object

Required

Wrapped error response.

Example request (cURL)

```bash
curl -X GET "https://api.linkbreakers.com/v1/qrcode-designs/{id}" \
  -H "Authorization: Bearer YOUR_TOKEN"
```

Typical response

```json
{
  "qrcodeDesign": {
    "backgroundOptions": {
      "themeColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      }
    },
    "centralImageMargin": 0,
    "centralImageSignedUrl": "https://example.com",
    "centralImageSize": 0,
    "cornersDotOptions": {
      "themeColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "type": "CORNERS_DOT_TYPE_UNSPECIFIED"
    },
    "cornersSquareOptions": {
      "themeColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "type": "CORNERS_SQUARE_TYPE_UNSPECIFIED"
    },
    "createdAt": "2026-10-13T03:21:20.078Z",
    "dotsOptions": {
      "themeColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "type": "DOTS_TYPE_UNSPECIFIED"
    },
    "errorCorrectionLevel": "string",
    "height": 0,
    "hideBackgroundDots": false,
    "id": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
    "outputFileFormat": "OUTPUT_FILE_FORMAT_PNG",
    "shape": "SHAPE_SQUARE",
    "updatedAt": "2026-10-13T03:21:20.078Z",
    "width": 0
  }
}
```

Base URL: `https://api.linkbreakers.com`

POST

`/v1/public/qrcode-designs`

## [#](#create-a-new-qr-code-design)Create a new QR code design

Provision a QR code styling preset that can be reused across links or templates.

### [#](#create-a-new-qr-code-design-parameters)Parameters

#### header parameters

Idempotency-Key

string

header

Makes retrying this request safe. See components.parameters.IdempotencyKey.

### [#](#create-a-new-qr-code-design-request)Request body

backgroundOptions

object

BackgroundOptions represents the styling options for the QR code background

centralImageData

string

The image to use as the central image of the QR Code. The file size limit is 3MB. It must be transmitted in a base64 string format when sending it through HTTP.

centralImageMargin

integer (int32)

The margin around the central image in pixels

centralImageSize

number (double)

The size of the central image relative to the QR code

cornersDotOptions

object

CornersDotOptions represents the styling options for the dot corners in the QR code

cornersSquareOptions

object

CornersSquareOptions represents the styling options for the square corners in the QR code

dotsOptions

object

DotsOptions represents the styling options for the dots in the QR code

errorCorrectionLevel

string

The error correction level of the QR code

height

integer (int32)

The height of the QR code

hideBackgroundDots

boolean

Whether to hide the background dots

outputFileFormat

string (enum)

The output file format for the QR code

##### Allowed values

`OUTPUT_FILE_FORMAT_UNSPECIFIED`

Output format not specified (defaults to PNG server-side)

`OUTPUT_FILE_FORMAT_SVG`

Scalable Vector Graphics format for infinite resolution

`OUTPUT_FILE_FORMAT_PNG`

Portable Network Graphics format with transparency support

`OUTPUT_FILE_FORMAT_JPEG`

Joint Photographic Experts Group format for compressed images

`OUTPUT_FILE_FORMAT_WEBP`

WebP format for modern web-optimized compression

shape

string (enum)

The shape of the QR code

##### Allowed values

`SHAPE_UNSPECIFIED`

Shape not specified (defaults to square modules)

`SHAPE_SQUARE`

Traditional square modules for QR code data points

`SHAPE_CIRCLE`

Circular modules for a rounded visual appearance

width

integer (int32)

The width of the QR code

### [#](#create-a-new-qr-code-design-response)Response

200

Everything worked as expected.

qrcodeDesign

object

Captures the visual recipe Linkbreakers uses when rendering downloadable QR codes, including colors, shapes, export options, and center media. QR Code Designs are the visual representation of a link. They can be attached to QR Code Templates for reusability. They can only be attached to one record at a time.

### [#](#create-a-new-qr-code-design-error)Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

object

Required

Wrapped error response.

Example request (cURL)

```bash
curl -X POST "https://api.linkbreakers.com/v1/public/qrcode-designs" \
  -H "Idempotency-Key: string" \
  -H "Content-Type: application/json" \
  --data '{"backgroundOptions":{"themeColor":{"colors":["string"],"direction":"string","stops":["string"],"type":"THEME_COLOR_TYPE_UNSPECIFIED"}},"centralImageData":"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==","centralImageMargin":0,"centralImageSize":0,"cornersDotOptions":{"themeColor":{"colors":["string"],"direction":"string","stops":["string"],"type":"THEME_COLOR_TYPE_UNSPECIFIED"},"type":"CORNERS_DOT_TYPE_UNSPECIFIED"},"cornersSquareOptions":{"themeColor":{"colors":["string"],"direction":"string","stops":["string"],"type":"THEME_COLOR_TYPE_UNSPECIFIED"},"type":"CORNERS_SQUARE_TYPE_UNSPECIFIED"},"dotsOptions":{"themeColor":{"colors":["string"],"direction":"string","stops":["string"],"type":"THEME_COLOR_TYPE_UNSPECIFIED"},"type":"DOTS_TYPE_UNSPECIFIED"},"errorCorrectionLevel":"string","height":0,"hideBackgroundDots":false,"outputFileFormat":"OUTPUT_FILE_FORMAT_WEBP","shape":"SHAPE_SQUARE","width":0}'
```

Sample payload (application/json)

```json
{
  "backgroundOptions": {
    "themeColor": {
      "colors": [
        "string"
      ],
      "direction": "string",
      "stops": [
        "string"
      ],
      "type": "THEME_COLOR_TYPE_UNSPECIFIED"
    }
  },
  "centralImageData": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==",
  "centralImageMargin": 0,
  "centralImageSize": 0,
  "cornersDotOptions": {
    "themeColor": {
      "colors": [
        "string"
      ],
      "direction": "string",
      "stops": [
        "string"
      ],
      "type": "THEME_COLOR_TYPE_UNSPECIFIED"
    },
    "type": "CORNERS_DOT_TYPE_UNSPECIFIED"
  },
  "cornersSquareOptions": {
    "themeColor": {
      "colors": [
        "string"
      ],
      "direction": "string",
      "stops": [
        "string"
      ],
      "type": "THEME_COLOR_TYPE_UNSPECIFIED"
    },
    "type": "CORNERS_SQUARE_TYPE_UNSPECIFIED"
  },
  "dotsOptions": {
    "themeColor": {
      "colors": [
        "string"
      ],
      "direction": "string",
      "stops": [
        "string"
      ],
      "type": "THEME_COLOR_TYPE_UNSPECIFIED"
    },
    "type": "DOTS_TYPE_UNSPECIFIED"
  },
  "errorCorrectionLevel": "string",
  "height": 0,
  "hideBackgroundDots": false,
  "outputFileFormat": "OUTPUT_FILE_FORMAT_WEBP",
  "shape": "SHAPE_SQUARE",
  "width": 0
}
```

Typical response

```json
{
  "qrcodeDesign": {
    "backgroundOptions": {
      "themeColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      }
    },
    "centralImageMargin": 0,
    "centralImageSignedUrl": "https://example.com",
    "centralImageSize": 0,
    "cornersDotOptions": {
      "themeColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "type": "CORNERS_DOT_TYPE_UNSPECIFIED"
    },
    "cornersSquareOptions": {
      "themeColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "type": "CORNERS_SQUARE_TYPE_UNSPECIFIED"
    },
    "createdAt": "2026-10-13T03:21:20.077Z",
    "dotsOptions": {
      "themeColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "type": "DOTS_TYPE_UNSPECIFIED"
    },
    "errorCorrectionLevel": "string",
    "height": 0,
    "hideBackgroundDots": false,
    "id": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
    "outputFileFormat": "OUTPUT_FILE_FORMAT_PNG",
    "shape": "SHAPE_SQUARE",
    "updatedAt": "2026-10-13T03:21:20.077Z",
    "width": 0
  }
}
```

Base URL: `https://api.linkbreakers.com`

POST

`/v1/qrcode-designs/apply-template`

Requires auth

## [#](#apply-a-qr-code-template-to-a-link)Apply a QR code template to a link

Copy all design settings from a community QR code template to an existing link's QR code design. This replaces the current design with the template's styling. Requires the \`qrcodes:write\` scope.

### [#](#apply-a-qr-code-template-to-a-link-parameters)Parameters

#### header parameters

Idempotency-Key

string

header

Makes retrying this request safe. See components.parameters.IdempotencyKey.

### [#](#apply-a-qr-code-template-to-a-link-request)Request body

linkId

string

Required

The ID of the link to apply the template to (UUID)

qrcodeTemplateId

string

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

templateSlug

string

Slug of the QR code 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 qrcode\_template\_id instead for a workspace's own templates, which have none. Exactly one of the two is required.

### [#](#apply-a-qr-code-template-to-a-link-response)Response

200

Everything worked as expected.

qrcodeDesign

object

Captures the visual recipe Linkbreakers uses when rendering downloadable QR codes, including colors, shapes, export options, and center media. QR Code Designs are the visual representation of a link. They can be attached to QR Code Templates for reusability. They can only be attached to one record at a time.

### [#](#apply-a-qr-code-template-to-a-link-error)Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

object

Required

Wrapped error response.

Example request (cURL)

```bash
curl -X POST "https://api.linkbreakers.com/v1/qrcode-designs/apply-template" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Idempotency-Key: string" \
  -H "Content-Type: application/json" \
  --data '{"linkId":"550e8400-e29b-41d4-a716-446655440000","qrcodeTemplateId":"550e8400-e29b-41d4-a716-446655440000","templateSlug":"google-dinosaur"}'
```

Sample payload (application/json)

```json
{
  "linkId": "550e8400-e29b-41d4-a716-446655440000",
  "qrcodeTemplateId": "550e8400-e29b-41d4-a716-446655440000",
  "templateSlug": "google-dinosaur"
}
```

Typical response

```json
{
  "qrcodeDesign": {
    "backgroundOptions": {
      "themeColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      }
    },
    "centralImageMargin": 0,
    "centralImageSignedUrl": "https://example.com",
    "centralImageSize": 0,
    "cornersDotOptions": {
      "themeColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "type": "CORNERS_DOT_TYPE_UNSPECIFIED"
    },
    "cornersSquareOptions": {
      "themeColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "type": "CORNERS_SQUARE_TYPE_UNSPECIFIED"
    },
    "createdAt": "2026-10-13T03:21:20.078Z",
    "dotsOptions": {
      "themeColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "type": "DOTS_TYPE_UNSPECIFIED"
    },
    "errorCorrectionLevel": "string",
    "height": 0,
    "hideBackgroundDots": false,
    "id": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
    "outputFileFormat": "OUTPUT_FILE_FORMAT_PNG",
    "shape": "SHAPE_SQUARE",
    "updatedAt": "2026-10-13T03:21:20.078Z",
    "width": 0
  }
}
```

Base URL: `https://api.linkbreakers.com`

PATCH

`/v1/qrcode-designs/{id}`

Requires auth

## [#](#update-a-qr-code-design)Update a QR code design

Apply styling tweaks or media changes to an existing QR code design. Requires the \`qrcodes:write\` scope.

### [#](#update-a-qr-code-design-parameters)Parameters

#### path parameters

id

string

Required

path

The ID of the QR code design to update (UUID)

#### header parameters

Idempotency-Key

string

header

Makes retrying this request safe. See components.parameters.IdempotencyKey.

### [#](#update-a-qr-code-design-request)Request body

backgroundOptions

object

BackgroundOptions represents the styling options for the QR code background

centralImageData

string

The image to use as the central image of the QR Code. The file size limit is 3MB. It must be transmitted in a base64 string format when sending it through HTTP.

centralImageDelete

boolean

Set this to true to delete the central image. It can't be used at the same time as transmitting a central image.

centralImageMargin

integer (int32)

The margin around the central image in pixels

centralImageSize

number (double)

The size of the central image relative to the QR code

cornersDotOptions

object

CornersDotOptions represents the styling options for the dot corners in the QR code

cornersSquareOptions

object

CornersSquareOptions represents the styling options for the square corners in the QR code

dotsOptions

object

DotsOptions represents the styling options for the dots in the QR code

errorCorrectionLevel

string

The error correction level of the QR code

height

integer (int32)

The height of the QR code

hideBackgroundDots

boolean

Whether to hide the background dots

outputFileFormat

string (enum)

The output file format for the QR code

##### Allowed values

`OUTPUT_FILE_FORMAT_UNSPECIFIED`

Output format not specified (defaults to PNG server-side)

`OUTPUT_FILE_FORMAT_SVG`

Scalable Vector Graphics format for infinite resolution

`OUTPUT_FILE_FORMAT_PNG`

Portable Network Graphics format with transparency support

`OUTPUT_FILE_FORMAT_JPEG`

Joint Photographic Experts Group format for compressed images

`OUTPUT_FILE_FORMAT_WEBP`

WebP format for modern web-optimized compression

shape

string (enum)

The shape of the QR code

##### Allowed values

`SHAPE_UNSPECIFIED`

Shape not specified (defaults to square modules)

`SHAPE_SQUARE`

Traditional square modules for QR code data points

`SHAPE_CIRCLE`

Circular modules for a rounded visual appearance

width

integer (int32)

The width of the QR code

### [#](#update-a-qr-code-design-response)Response

200

Everything worked as expected.

qrcodeDesign

object

Captures the visual recipe Linkbreakers uses when rendering downloadable QR codes, including colors, shapes, export options, and center media. QR Code Designs are the visual representation of a link. They can be attached to QR Code Templates for reusability. They can only be attached to one record at a time.

### [#](#update-a-qr-code-design-error)Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

object

Required

Wrapped error response.

Example request (cURL)

```bash
curl -X PATCH "https://api.linkbreakers.com/v1/qrcode-designs/{id}" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Idempotency-Key: string" \
  -H "Content-Type: application/json" \
  --data '{"backgroundOptions":{"themeColor":{"colors":["string"],"direction":"string","stops":["string"],"type":"THEME_COLOR_TYPE_UNSPECIFIED"}},"centralImageData":"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==","centralImageDelete":false,"centralImageMargin":0,"centralImageSize":0,"cornersDotOptions":{"themeColor":{"colors":["string"],"direction":"string","stops":["string"],"type":"THEME_COLOR_TYPE_UNSPECIFIED"},"type":"CORNERS_DOT_TYPE_UNSPECIFIED"},"cornersSquareOptions":{"themeColor":{"colors":["string"],"direction":"string","stops":["string"],"type":"THEME_COLOR_TYPE_UNSPECIFIED"},"type":"CORNERS_SQUARE_TYPE_UNSPECIFIED"},"dotsOptions":{"themeColor":{"colors":["string"],"direction":"string","stops":["string"],"type":"THEME_COLOR_TYPE_UNSPECIFIED"},"type":"DOTS_TYPE_UNSPECIFIED"},"errorCorrectionLevel":"string","height":0,"hideBackgroundDots":false,"outputFileFormat":"OUTPUT_FILE_FORMAT_SVG","shape":"SHAPE_CIRCLE","width":0}'
```

Sample payload (application/json)

```json
{
  "backgroundOptions": {
    "themeColor": {
      "colors": [
        "string"
      ],
      "direction": "string",
      "stops": [
        "string"
      ],
      "type": "THEME_COLOR_TYPE_UNSPECIFIED"
    }
  },
  "centralImageData": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==",
  "centralImageDelete": false,
  "centralImageMargin": 0,
  "centralImageSize": 0,
  "cornersDotOptions": {
    "themeColor": {
      "colors": [
        "string"
      ],
      "direction": "string",
      "stops": [
        "string"
      ],
      "type": "THEME_COLOR_TYPE_UNSPECIFIED"
    },
    "type": "CORNERS_DOT_TYPE_UNSPECIFIED"
  },
  "cornersSquareOptions": {
    "themeColor": {
      "colors": [
        "string"
      ],
      "direction": "string",
      "stops": [
        "string"
      ],
      "type": "THEME_COLOR_TYPE_UNSPECIFIED"
    },
    "type": "CORNERS_SQUARE_TYPE_UNSPECIFIED"
  },
  "dotsOptions": {
    "themeColor": {
      "colors": [
        "string"
      ],
      "direction": "string",
      "stops": [
        "string"
      ],
      "type": "THEME_COLOR_TYPE_UNSPECIFIED"
    },
    "type": "DOTS_TYPE_UNSPECIFIED"
  },
  "errorCorrectionLevel": "string",
  "height": 0,
  "hideBackgroundDots": false,
  "outputFileFormat": "OUTPUT_FILE_FORMAT_SVG",
  "shape": "SHAPE_CIRCLE",
  "width": 0
}
```

Typical response

```json
{
  "qrcodeDesign": {
    "backgroundOptions": {
      "themeColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      }
    },
    "centralImageMargin": 0,
    "centralImageSignedUrl": "https://example.com",
    "centralImageSize": 0,
    "cornersDotOptions": {
      "themeColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "type": "CORNERS_DOT_TYPE_UNSPECIFIED"
    },
    "cornersSquareOptions": {
      "themeColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "type": "CORNERS_SQUARE_TYPE_UNSPECIFIED"
    },
    "createdAt": "2026-10-13T03:21:20.080Z",
    "dotsOptions": {
      "themeColor": {
        "colors": [],
        "direction": "string",
        "stops": [],
        "type": "THEME_COLOR_TYPE_UNSPECIFIED"
      },
      "type": "DOTS_TYPE_UNSPECIFIED"
    },
    "errorCorrectionLevel": "string",
    "height": 0,
    "hideBackgroundDots": false,
    "id": "a8c5e111-8894-4f8a-b5db-9efe0d12a210",
    "outputFileFormat": "OUTPUT_FILE_FORMAT_PNG",
    "shape": "SHAPE_SQUARE",
    "updatedAt": "2026-10-13T03:21:20.080Z",
    "width": 0
  }
}
```

Base URL: `https://api.linkbreakers.com`

DELETE

`/v1/qrcode-designs/{id}`

Requires auth

## [#](#delete-a-qr-code-design)Delete a QR code design

Remove a QR code design that is no longer in use by any assets. Requires the \`qrcodes:write\` scope.

### [#](#delete-a-qr-code-design-parameters)Parameters

#### path parameters

id

string

Required

path

The ID of the QR code design to delete

### [#](#delete-a-qr-code-design-response)Response

200

Everything worked as expected.

No structured schema available for this section.

### [#](#delete-a-qr-code-design-error)Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

object

Required

Wrapped error response.

Example request (cURL)

```bash
curl -X DELETE "https://api.linkbreakers.com/v1/qrcode-designs/{id}" \
  -H "Authorization: Bearer YOUR_TOKEN"
```

Typical response

```json
{}
```

Base URL: `https://api.linkbreakers.com`

Cookies

We use cookies to measure our ads with Meta and Google. Our own analytics are cookie-free and run either way. [Privacy statement](https://linkbreakers.com/privacy#cookies)

---

Source: https://linkbreakers.com/help/api/qr-code-designs