> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Change a QR Code's category
> PATCH /qr/{qrid}/change-category/
Moves a Dynamic QR Code to a different category.
```
PATCH https://api.scanova.io/qr/{qrid}/change-category/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
```
The QR Code's `qrid`.
Primary key of the destination category.
```bash cURL theme={null}
curl -X PATCH "https://api.scanova.io/qr/Qa1b2c3d4e5f6g7h8/change-category/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{
"category": 8
}'
```
**This is destructive.** On success the QR Code's stored `info` is wiped to an empty string and its previous content and media are discarded — the old category's content cannot be recovered. It is not a metadata-only edit. Expect to immediately follow up with [Update a QR Code](/api-reference/management-api/qr/update) to populate `info` for the new category.
The short URL, `qrid`, scan history, and design survive the change; only the content does not.
```json 400 Bad Request theme={null}
{
"qr_type": ["Edit category on static QR codes is not allowed."]
}
```
Category changes are refused for **static** QR Codes and for **static-only** target categories — a static QR Code's payload is baked into the printed pattern, so there is nothing to repoint.
## Related
* [Update a QR Code](/api-reference/management-api/qr/update) — populate `info` for the new category afterwards.
* [List QR categories](/api-reference/management-api/qr/category-list) — pick a destination category that allows `dy`.
* [Retrieve a QR Code](/api-reference/management-api/qr/retrieve) — confirm the wiped content and new category.
* [QR Manager overview](/api-reference/management-api/qr/overview) — the quotas, role permissions, and Trash model shared by every endpoint in this module.
* [Management API overview](/api-reference/management-api/overview) — the auth scheme and quota rules that apply to this endpoint.
## OpenAPI
````yaml api-reference/openapi/management-api.json PATCH /qr/{qrid}/change-category/
openapi: 3.1.0
info:
title: Scanova Management API (v2)
description: >-
The complete Scanova Management API — every endpoint available at
api.scanova.io (QR codes, folders, tags, leads, forms, analytics, plans,
shared users & roles), plus the token-creation and usage-stats endpoints
used to authenticate against it. Every path and request/response shape below
was verified live against a real API key and the actual running backend
(Phase 7, 2026-08-16) — not guessed from reading urls.py alone.
version: 2.0.0
servers:
- url: https://api.scanova.io
description: Management API — QR/folder/tag/lead/form/analytics/plans endpoints
security:
- apiKeyAuth: []
paths:
/qr/{qrid}/change-category/:
patch:
summary: Change a QR code's category
description: >-
Moves a Dynamic QR code to a different category. DESTRUCTIVE: on success
the stored `info` is wiped to an empty string and the old content and
media are discarded — this is not a metadata-only edit. Blocked with 400
for static QR codes and for static-only target categories. Returns the
full QR code.
operationId: changeQrCodeCategory
parameters:
- name: qrid
in: path
required: true
schema:
type: string
description: >-
The QR code's `qrid` — the opaque public identifier returned by the
list endpoint, not the numeric `id`.
requestBody:
content:
application/json:
example:
category: 8
responses:
'200':
description: Category changed — content has been wiped.
content:
application/json:
example:
id: 1042
qrid: Qa1b2c3d4e5f6g7h8
name: Summer Sale Landing
qr_type: dy
qr_type_display: Dynamic
category:
id: 8
name: PDF
slug: pdf
allowed_qr_types: dy
has_landing_page: true
info: ''
pattern_info: null
svg_code: null
dynamic_url_object:
id: 501
url_hash: a1b2c3d4
custom_domain: null
complete_url: https://scnv.io/a1b2c3d4
qr_url: https://scnv.io/a1b2c3d4
is_active: true
is_expired: false
visit_count: 0
web_tracking_site_id: null
thumbnail: null
is_active: true
folder: null
version: 2
tags_list:
- campaign-2026
- print
is_password_protected: false
is_age_restricted: false
is_designer: false
high_accuracy_mode: false
activate_on: null
expire_on: null
expire_on_scan_count: null
minimum_age: null
is_page: false
has_qr: true
is_draft: false
draft_info: null
draft_saved_at: null
published_at: '2026-09-01T10:04:11Z'
is_currently_draft: false
created: '2026-09-01T10:04:11Z'
modified: '2026-09-01T10:04:11Z'
'400':
description: Static QR code, or a static-only target category.
content:
application/json:
example:
qr_type:
- Edit category on static QR codes is not allowed.
'404':
description: No QR code with this `qrid` owned by this account.
components:
securitySchemes:
apiKeyAuth:
type: apiKey
in: header
name: Authorization
description: >-
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.
````