v4

latestOpenAPI 3.1.0AGPL-3.02026-08-0821527.0 KB

Edit a dynamic code (any field the dashboard can edit)

Send only the fields you want to change: destination, label, custom slug, tags, folder or style.

patch/v1/dynamic/{id}

Request body

destinationstring uri

labelstring nullable

slugstring

Custom short-link back-half: 3–48 letters, numbers or hyphens.

tagsstring[]

Replaces the code's tags (max 10).

folder_idstring nullable

Folder id to file under, or null to un-file.

styleobject

QR style JSON (colours, dot/corner shapes, etc.) for re-download.

themestring

A saved theme id or name to restyle the code with (sets style).

passwordstring nullable

Pro: require this password (min 4 characters) before the code redirects. Pass null to remove all protection.

pinstring nullable

Pro: require a 4-digit PIN before the code redirects. Exactly 4 digits. Pass null to remove all protection.

lock_type'pin' | 'password'

Which input scanners see.

lock_hintstring nullable

Optional hint shown on the unlock page, e.g. "Ask at the bar". Max 60 characters.

Response

Updated.

idstring

slugstring

short_urlstring uri

destinationstring uri

labelstring nullable

Example response

{
  "id": "9f8b2c1a-4e7d-4a90-b2f1-0c3d5e6a7b8c",
  "slug": "spring-menu",
  "short_url": "https://oqr.to/spring-menu",
  "destination": "https://example.com/menu"
}