TEASEDocs
API ReferenceLandings

Edit a QR code

Partially updates a QR code; only supplied fields change. Renaming the slug moves the public scan path while the source label — and the code's stats history — stays unchanged; mind media already printed with the old path, which keeps redirecting but no longer carries the label. active: false stops labelling scans without breaking the printed redirect. design/preset replace the stored design (design wins). Changes are live immediately. Requires a write-scoped key.

Authorization

bearerAuth
AuthorizationBearer <token>

Your al_live_<prefix>_<secret> API key. Mint and manage keys in the dashboard.

In: header

Path Parameters

domain*string

Registered hostname, e.g. links.creator.com.

qr_id*integer

QR code id.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

PATCH
/api/admin/qr/{domain}/{qr_id}
curl -X PATCH "https://example.com/api/admin/qr/string/0" \  -H "Content-Type: application/json" \  -d '{    "slug": "flyer-2",    "active": true  }'
{  "id": 3,  "domain": "links.creator.com",  "slug": "flyer",  "path": "/qr/flyer",  "title": "Club flyer",  "channel": "instagram",  "source": "qr-flyer",  "design": {    "module": "rounded",    "eye_frame": "rounded",    "eye_dot": "rounded",    "fg_grad": {      "kind": "linear",      "stops": [        [          0,          "#7a3ff2"        ],        [          0.5,          "#e1306c"        ],        [          1,          "#fcaf45"        ]      ]    },    "bg": "#ffffff",    "card_radius": 28  },  "active": true,  "created_at": 1752537600,  "updated_at": 1752537600,  "stats": {    "scans": 214,    "visits": 198,    "clicks": 161,    "subs": 7,    "revenue_cents": 41300  }}
{  "detail": {    "code": "slug_taken",    "message": "Путь /qr/flyer-2 на links.creator.com уже занят"  }}
{  "detail": "auth required"}
{  "detail": {    "code": "qr_not_found",    "message": "QR-код не найден"  }}

Create a QR code

Creates a printable QR entry point on the domain. slug '' claims the main /qr path; a named slug serves /qr/<slug>. The source label ('qr' or 'qr-<slug>') is stamped once at creation and never changes. Send a full design, a catalog preset id, or neither (the stock design); design wins when both are sent. QR codes live outside the draft lifecycle — changes apply to the live domain immediately, no publish needed. Requires a write-scoped key.

Delete a QR code

Deletes the QR code card. Media already printed keeps redirecting to the landing (never a 404) — its scans simply stop being labelled and counted. Requires a write-scoped key.