---
title: "Create or update link QR code settings"
method: POST
path: "/links/qr/settings/{linkIdString}"
tags: ["QR Codes"]
---

# Create or update link QR code settings

`POST /links/qr/settings/{linkIdString}`

## Request

- Base URL: `https://api.short.io`
- URL: `https://api.short.io/links/qr/settings/{linkIdString}`
- Auth: API key in header `Authorization`

Saves the QR code settings for the link. Omitted fields are left untouched; send an empty string to clear a text field.

## Path parameters

- `linkIdString` string, required

## Request body

- object
  - `logoUrl` string: URL of the logo image embedded in the QR code
  - `color` string: 6 or 8-character hex color without # prefix (RRGGBB or RRGGBBAA)
  - `backgroundColor` string: 6 or 8-character hex color without # prefix (RRGGBB or RRGGBBAA)
  - `logoHeight` integer: Logo height in pixels
  - `logoWidth` integer: Logo width in pixels
  - `ecLevel` 'L' | 'M' | 'Q' | 'H': QR code error correction level
  - `borderRadius` integer: Dot border radius on the dashboard 0-5 scale, 5 = fully round
  - `noExcavate` boolean: Disable logo excavation (cutout) in the QR code
  - `finderOuterShape` 'square' | 'rounded' | 'circle' | 'drop': Shape of the outer finder pattern
  - `finderInnerShape` 'square' | 'rounded' | 'circle' | 'drop': Shape of the inner finder pattern
  - `finderColor` string: 6 or 8-character hex color without # prefix (RRGGBB or RRGGBBAA)
  - `cornerMode` 'individual' | 'merge': Corner module rendering mode
  - `labelText` string: Optional text label rendered with the QR code
  - `labelStyle` 'below' | 'pill' | 'box': Label visual style
  - `labelColor` string: 6 or 8-character hex color without # prefix (RRGGBB or RRGGBBAA)
  - `labelBgColor` string: 6 or 8-character hex color without # prefix (RRGGBB or RRGGBBAA)
  - `labelFontSize` integer: Label font size in module units (rendered px = value * block size)
  - `labelFontFamily` string: Label font family name

## Response `200`

Default Response

---

[API](https://skmtc.dev/short/apis/short-io-api-2.md) · [All operations](https://skmtc.dev/short/apis/short-io-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/short/apis/short-io-api-2/revisions/9e4e60c560b1?raw)