Update QR Code

Update a QR code (full replace)

curl --request PUT \
  --url https://api.scanova.io/qr/{qrid}/ \
  --header 'Authorization: <api-key>'

const options = {method: 'PUT', headers: {Authorization: '<api-key>'}};

fetch('https://api.scanova.io/qr/{qrid}/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.scanova.io/qr/{qrid}/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.scanova.io/qr/{qrid}/"

	req, _ := http.NewRequest("PUT", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.scanova.io/qr/{qrid}/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

PUT

{qrid}

Update a QR code (full replace)

curl --request PUT \
  --url https://api.scanova.io/qr/{qrid}/ \
  --header 'Authorization: <api-key>'

const options = {method: 'PUT', headers: {Authorization: '<api-key>'}};

fetch('https://api.scanova.io/qr/{qrid}/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.scanova.io/qr/{qrid}/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.scanova.io/qr/{qrid}/"

	req, _ := http.NewRequest("PUT", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.scanova.io/qr/{qrid}/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

Behavior / Notes

Use this endpoint to update mutable fields such as name, info, pattern_info, expiry settings, geo-fencing, lead capture, password, and other advanced toggles.
Fields that are immutable after creation: category, qr_type, custom_domain. Attempting to change them will return a validation error.
PUT replaces the mutable fields you submit — only include fields you want changed. (If your client supports PATCH, prefer it for partial updates; otherwise send only the fields you intend to update.)
Validate new info payloads with POST /qr/validate-info/ before updating to avoid broken landing pages.

Request Body — Updatable Fields

The following fields may be included in the JSON request body. Only include fields you want to change. Common / Editable fields

Field	Type	Description
`name`	`string`	New name for the QR Code
`info`	`string`	JSON string containing updated QR content (see Components Reference)
`pattern_info`	`object` or `string`	Design updates (pattern, colors, eyes, frame). Serialize if required by client
`expire_on`	`string` (date-time)	Expiration timestamp (advanced feature)
`expire_on_text`	`string` (HTML)	HTML displayed when QR is expired
`expire_on_timezone`	`string`	Timezone for expiration (e.g., `Asia/Kolkata`)
`high_accuracy_confirmation`	`boolean`	High-accuracy confirmation for location QR codes
`high_accuracy_geo_fencing`	`boolean`	Toggle geo-fencing
`high_accuracy_geo_fencing_config`	`object`	Geo-fencing config (displayText, fallback, mapLocation, range, unit, redirectUrl)
`high_accuracy_mode`	`boolean`	Request location access behavior toggle
`high_accuracy_mode_text`	`string`	Text shown when requesting location permission
`lead_list`	`integer` or `null`	Lead list ID to capture leads. Set `null` to remove link.
`minimum_age`	`integer`	Minimum age to access content
`password`	`string`	Password to protect QR Code content

Tip: Set lead_list: null to remove the lead list association.

Examples

Update QR Code Name

curl -X PUT "https://management.scanova.io/qr/Q3493df1c0e074ac7/" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated QR Code Name"
  }'

Update QR Code Content

curl -X PUT "https://management.scanova.io/qr/Q3493df1c0e074ac7/" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated Website QR Code",
    "info": "{\"type\":\"url\",\"data\":{\"url\":\"https://updated-website.com\"}}"
  }'

Update Advanced Features

curl -X PUT "https://management.scanova.io/qr/Q3493df1c0e074ac7/" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Advanced QR Code",
    "expire_on": "2025-12-31T23:59:59+05:30",
    "expire_on_timezone": "Asia/Kolkata",
    "expire_on_text": "<div style=\"text-align:center\"><p>This QR code has expired</p></div>",
    "high_accuracy_mode": true,
    "high_accuracy_mode_text": "Location access required for this QR code",
    "high_accuracy_confirmation": true,
    "minimum_age": 18,
    "password": "securepassword123"
  }'

Update Geo-fencing Configuration

curl -X PUT "https://management.scanova.io/qr/Q3493df1c0e074ac7/" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "high_accuracy_geo_fencing": true,
    "high_accuracy_geo_fencing_config": {
      "unit": "ft",
      "range": 500,
      "fallback": "message",
      "displayText": "<p>This QR code is location-restricted. Please enable GPS and try again.</p>",
      "mapLocation": {
        "provider": "google",
        "latitude": 40.7127753,
        "longitude": -74.0059728,
        "placeId": "",
        "placeName": "New York"
      },
      "redirectUrl": ""
    }
  }'

Update Lead List

curl -X PUT "https://management.scanova.io/qr/Q3493df1c0e074ac7/" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "lead_list": 1106
  }'

Remove Lead List

curl -X PUT "https://management.scanova.io/qr/Q3493df1c0e074ac7/" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "lead_list": null
  }'

Immutable-field errors

If an attempt is made to modify an immutable field (category, qr_type, custom_domain), the API will return a validation error describing the immutability.

Best Practices & Recommendations

Validate before updating: Use POST /qr/validate-info/ to confirm info payload correctness.
Sanitize HTML: Any HTML fields (expire_on_text, high_accuracy_geo_fencing_config.displayText) should be sanitized to prevent XSS on landing pages.
Minimize update payloads: Send only the fields you intend to change to avoid accidental overwrites.
Audit & versioning: Log update operations (who changed what and when) if your workflow requires auditability.
Plan entitlements: Confirm advanced features (geo-fencing, expiry, custom domains, lead capture) are enabled in the account plan before updating.
Test scanning: After UI/design changes (pattern_info), test scanning across devices and apps to ensure scannability.

Authorizations

Authorization

string

header

required

Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: YOUR_API_KEY. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. api.scanova.io) — the same key sent to the regular API host will not authenticate.

Path Parameters

qrid

string

required

Response

200

QR code updated

Getting Started

Reference

QR Code Management

Folder Management

Form Management

Lead List Management

User Management

Analytics & Reporting

Behavior / Notes

Request Body — Updatable Fields

Examples

Update QR Code Name

Update QR Code Content

Update Advanced Features

Update Geo-fencing Configuration

Update Lead List

Remove Lead List

Immutable-field errors

Best Practices & Recommendations

Authorizations

Path Parameters

Response

​Behavior / Notes

​Request Body — Updatable Fields

​Examples

​Update QR Code Name

​Update QR Code Content

​Update Advanced Features

​Update Geo-fencing Configuration

​Update Lead List

​Remove Lead List

​Immutable-field errors

​Best Practices & Recommendations

Authorizations

Path Parameters

Response

Behavior / Notes

Request Body — Updatable Fields

Examples

Update QR Code Name

Update QR Code Content

Update Advanced Features

Update Geo-fencing Configuration

Update Lead List

Remove Lead List

Immutable-field errors

Best Practices & Recommendations