Update QR Code

Update an existing QR code. Only the fields you include will be updated.

PATCH/qr-codes/:id

Headers

Header	Required	Description
X-API-Key	Required	Your API key
Content-Type	Required	application/json
QR-Version	Optional	API version (e.g., 2026-02-16)

Path Parameters

Parameter	Type	Description
id	string	The QR code ID

Body Parameters

All fields are optional. Only include the fields you want to update.

Parameter	Type	Required	Description
name	string	Optional	New name for the QR code
content	object	Optional	New content data
design	object	Optional	New design options (merged with existing). Try the Builder.
active	boolean	Optional	Enable or disable the QR code
folder_id	string | null	Optional	Move to folder ID, or null to unassign (place in root). Requires Folders feature.

info

• The QR code image and short URL remain the same after updates
• Updating content changes where the QR code redirects
• Design updates are merged with the existing design — you only need to send the fields you want to change
• Set active: false to temporarily disable a QR code without deleting it

Request

cURL

curl -X PATCH "https://integration-api.qr-build.com/qr-codes/qr-aBc123XyZ9" \
  -H "X-API-Key: qrb_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "content": {
      "type": "url",
      "url": "https://new-destination.com"
    }
  }'

JavaScript

const response = await fetch(
  "https://integration-api.qr-build.com/qr-codes/qr-aBc123XyZ9",
  {
    method: "PATCH",
    headers: {
      "X-API-Key": "qrb_live_your_api_key_here",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      content: { type: "url", url: "https://new-destination.com" },
    }),
  }
);

const data = await response.json();

Python

import requests

response = requests.patch(
    "https://integration-api.qr-build.com/qr-codes/qr-aBc123XyZ9",
    headers={
        "X-API-Key": "qrb_live_your_api_key_here",
        "Content-Type": "application/json",
    },
    json={"content": {"type": "url", "url": "https://new-destination.com"}},
)

data = response.json()

Response

{
  "object": "qr",
  "success": true,
  "data": {
    "id": "qr-aBc123XyZ9",
    "name": "My Website QR",
    "type": "url",
    "content": {
      "url": "https://new-destination.com"
    },
    "design": {
      "dots": { "style": "rounded", "color": "#000000" },
      "corners": { "style": "extra-rounded", "color": "#000000" },
      "corners_dot": { "style": "dot", "color": "#000000" },
      "background": { "color": "#ffffff" },
      "logo_url": null,
      "margin": 10
    },
    "active": true,
    "short_url": "https://qr-build.io/qr-aBc123XyZ9",
    "created_at": "2026-02-16T10:30:00Z",
    "updated_at": "2026-02-16T11:45:00Z"
  },
  "message": "QR code updated successfully"
}

Error — Not Found

{
  "success": false,
  "error": {
    "code": "QR_NOT_FOUND",
    "message": "QR code not found"
  }
}