curl -X PATCH "https://api.scanova.io/qr/Qa1b2c3d4e5f6g7h8/ai/501/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{
"selected": true
}'
{
"id": 501,
"prompt": "cyberpunk city skyline at night",
"negative_prompt": "blurry, low quality",
"weight": 1.2,
"qr_code_pattern": null,
"preset": "illustration",
"provider": "quickqr",
"status": "generated",
"selected": true,
"is_scannable": true,
"qr_image_url": "https://cdn.scanova.io/ai/501.png",
"created": "2026-09-09T09:00:00Z"
}QR Codes
Retrieve and select an AI variant
GET, PATCH /qr//ai//
GET
/
qr
/
{qrid}
/
ai
/
{id}
/
curl -X PATCH "https://api.scanova.io/qr/Qa1b2c3d4e5f6g7h8/ai/501/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{
"selected": true
}'
{
"id": 501,
"prompt": "cyberpunk city skyline at night",
"negative_prompt": "blurry, low quality",
"weight": 1.2,
"qr_code_pattern": null,
"preset": "illustration",
"provider": "quickqr",
"status": "generated",
"selected": true,
"is_scannable": true,
"qr_image_url": "https://cdn.scanova.io/ai/501.png",
"created": "2026-09-09T09:00:00Z"
}Reads one AI variant record, and selects it as the QR Code’s chosen design.
GET https://api.scanova.io/qr/{qrid}/ai/{id}/
PATCH https://api.scanova.io/qr/{qrid}/ai/{id}/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
string
required
The QR Code’s
qrid.integer
required
The AI variant record’s id, from List and generate AI QR Code variants.
GET is also the polling endpoint while a generation is in flight — watch status until it leaves generating.
Select (PATCH)
boolean
The only writable field on this resource.
curl -X PATCH "https://api.scanova.io/qr/Qa1b2c3d4e5f6g7h8/ai/501/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{
"selected": true
}'
Setting
selected: true deselects every other AI variant for the same QR Code — exactly one variant is selected at a time. There is no call that selects two, and no need to deselect the previous one first.Related
- List and generate AI QR Code variants — the collection this record belongs to.
- Retrieve a QR Code — the QR Code the selected variant applies to.
- QR Manager overview — the quotas, role permissions, and Trash model shared by every endpoint in this module.
- Management API overview — the auth scheme and quota rules that apply to this endpoint.
Authorizations
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. 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
The QR code's qrid — the opaque public identifier returned by the list endpoint, not the numeric id.
The AI variant record's id.
Response
One AI variant.
Was this page helpful?