{"openapi":"3.1.0","info":{"title":"QR + link-in-bio API","version":"1","description":"Manage QR codes, bio pages and analytics with a project API key. Send it as `Authorization: Bearer qrc_…`. Every answer is JSON; errors use one envelope with a closed set of codes."},"paths":{"/analytics":{"get":{"operationId":"getAnalytics","tags":["analytics"],"summary":"The project's analytics","description":"What the Analytics page shows for the window: totals against the window before, the daily series, breakdowns, the top QR codes and recent events. Archived codes are left out.","parameters":[{"name":"range","in":"query","required":false,"description":"The window in days: 7, 30 or 90 (the default).","schema":{"default":"30","type":"string","enum":["7","30","90"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"range":{"anyOf":[{"type":"number","const":7},{"type":"number","const":30},{"type":"number","const":90}],"description":"The window, in days."},"totals":{"type":"object","properties":{"views":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Bio page views."},"clicks":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Button taps."},"redirects":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Redirect code scans."},"visitors":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Distinct visitors."}},"required":["views","clicks","redirects","visitors"],"additionalProperties":false},"previousTotals":{"type":"object","properties":{"views":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Bio page views."},"clicks":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Button taps."},"redirects":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Redirect code scans."},"visitors":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Distinct visitors."}},"required":["views","clicks","redirects","visitors"],"additionalProperties":false,"description":"The same numbers for the window just before."},"series":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","description":"`YYYY-MM-DD`."},"scans":{"type":"integer","minimum":0,"maximum":9007199254740991},"clicks":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["date","scans","clicks"],"additionalProperties":false}},"countries":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["label","value"],"additionalProperties":false}},"devices":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["label","value"],"additionalProperties":false}},"browsers":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["label","value"],"additionalProperties":false}},"languages":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["label","value"],"additionalProperties":false}},"referrers":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["label","value"],"additionalProperties":false}},"services":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["label","value"],"additionalProperties":false},"description":"Taps by the tapped button's service."},"topLinks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"slug":{"type":"string"},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"mode":{"type":"string","enum":["bio","redirect"]},"scans":{"type":"integer","minimum":0,"maximum":9007199254740991},"clicks":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","slug","title","mode","scans","clicks"],"additionalProperties":false}},"recent":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string","enum":["view","click","redirect"]},"slug":{"type":"string"},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"button":{"anyOf":[{"type":"object","properties":{"label":{"type":"string"},"type":{"type":"string"}},"required":["label","type"],"additionalProperties":false},{"type":"null"}],"description":"The tapped button; null for a view or a redirect."},"country":{"anyOf":[{"type":"string"},{"type":"null"}]},"deviceType":{"anyOf":[{"type":"string"},{"type":"null"}]},"browser":{"anyOf":[{"type":"string"},{"type":"null"}]},"ts":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","description":"ISO 8601, UTC, e.g. `2026-10-12T09:30:00.000Z`."}},"required":["id","type","slug","title","button","country","deviceType","browser","ts"],"additionalProperties":false}}},"required":["range","totals","previousTotals","series","countries","devices","browsers","languages","referrers","services","topLinks","recent"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}},"security":[{"bearerAuth":[]}]}},"/analytics/heatmap":{"get":{"operationId":"getAnalyticsHeatmap","tags":["analytics"],"summary":"The project's scan heatmap","description":"Scans by weekday and hour over the window.","parameters":[{"name":"range","in":"query","required":false,"description":"The window in days: 7, 30 or 90 (the default).","schema":{"default":"30","type":"string","enum":["7","30","90"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"range":{"anyOf":[{"type":"number","const":7},{"type":"number","const":30},{"type":"number","const":90}],"description":"The window, in days."},"cells":{"minItems":7,"maxItems":7,"type":"array","items":{"minItems":24,"maxItems":24,"type":"array","items":{"type":"integer","minimum":0,"maximum":9007199254740991}},"description":"Seven rows, Monday first, of 24 hours each (Europe/Athens): scans in that hour."}},"required":["range","cells"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}},"security":[{"bearerAuth":[]}]}},"/links":{"get":{"operationId":"listLinks","tags":["links"],"summary":"List QR codes","description":"The project's QR codes, newest first, with the QR codes page's search and tag filter. Live codes by default; `status=archived` or `all` for the rest. Paged by `limit` and `cursor`.","parameters":[{"name":"q","in":"query","required":false,"description":"Search text: matches the title, the slug and the destination, in any case.","schema":{"type":"string","maxLength":100}},{"name":"tag","in":"query","required":false,"description":"Only codes filed under this tag.","schema":{"type":"string","maxLength":100}},{"name":"status","in":"query","required":false,"description":"`active` (the default): live codes. `archived`: archived ones. `all`: both.","schema":{"default":"active","type":"string","enum":["active","archived","all"]}},{"name":"limit","in":"query","required":false,"description":"Items per page, 1 to 200.","schema":{"default":50,"type":"integer","minimum":1,"maximum":200}},{"name":"cursor","in":"query","required":false,"description":"Where the previous page ended: its `nextCursor`. Leave out for the first page.","schema":{"type":"string","maxLength":200}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"slug":{"type":"string","description":"Set once, at creation; the printed code's address never changes."},"url":{"type":"string","format":"uri","description":"The address the QR code encodes."},"mode":{"type":"string","enum":["bio","redirect"]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"destinationUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Where a redirect code sends people; null for a bio page."},"isActive":{"type":"boolean"},"tags":{"type":"array","items":{"type":"string"}},"archivedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","description":"ISO 8601, UTC, e.g. `2026-10-12T09:30:00.000Z`."},{"type":"null"}],"description":"Set while the code is archived; its printed code stops resolving."},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","description":"ISO 8601, UTC, e.g. `2026-10-12T09:30:00.000Z`."}},"required":["id","slug","url","mode","title","destinationUrl","isActive","tags","archivedAt","createdAt"],"additionalProperties":false}},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Pass as `cursor` for the next page; null on the last one."}},"required":["items","nextCursor"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}},"security":[{"bearerAuth":[]}]},"post":{"operationId":"createLink","tags":["links"],"summary":"Create a QR code","description":"A bio page or a redirect, with the same rules as the New QR code dialog: a redirect needs an `http(s)` destination; a `slug` is optional (one is derived from the title) and must be free. The project's brand kit, if any, sets the starting look.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string"},"mode":{"type":"string","enum":["bio","redirect"]},"slug":{"type":"string"},"destinationUrl":{"type":"string"}},"required":["mode"],"additionalProperties":false,"description":"`title` up to 120 characters; `mode` `bio` or `redirect`; `slug` optional, lower-case letters, digits and dashes; `destinationUrl` required for a redirect, `http(s)` only."}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"slug":{"type":"string","description":"Set once, at creation; the printed code's address never changes."},"url":{"type":"string","format":"uri","description":"The address the QR code encodes."},"mode":{"type":"string","enum":["bio","redirect"]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"subtitle":{"anyOf":[{"type":"string"},{"type":"null"}]},"destinationUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Where a redirect code sends people; null for a bio page."},"avatarUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"isActive":{"type":"boolean"},"tags":{"type":"array","items":{"type":"string"}},"archivedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","description":"ISO 8601, UTC, e.g. `2026-10-12T09:30:00.000Z`."},{"type":"null"}],"description":"Set while the code is archived; its printed code stops resolving."},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","description":"ISO 8601, UTC, e.g. `2026-10-12T09:30:00.000Z`."},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","description":"ISO 8601, UTC, e.g. `2026-10-12T09:30:00.000Z`."}},"required":["id","slug","url","mode","title","subtitle","destinationUrl","avatarUrl","isActive","tags","archivedAt","createdAt","updatedAt"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/PayloadTooLarge"},"415":{"$ref":"#/components/responses/UnsupportedMediaType"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}},"security":[{"bearerAuth":[]}]}},"/links/{id}":{"get":{"operationId":"getLink","tags":["links"],"summary":"Read a QR code","description":"One QR code, archived or not.","parameters":[{"name":"id","in":"path","required":true,"description":"The QR code's id.","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"slug":{"type":"string","description":"Set once, at creation; the printed code's address never changes."},"url":{"type":"string","format":"uri","description":"The address the QR code encodes."},"mode":{"type":"string","enum":["bio","redirect"]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"subtitle":{"anyOf":[{"type":"string"},{"type":"null"}]},"destinationUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Where a redirect code sends people; null for a bio page."},"avatarUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"isActive":{"type":"boolean"},"tags":{"type":"array","items":{"type":"string"}},"archivedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","description":"ISO 8601, UTC, e.g. `2026-10-12T09:30:00.000Z`."},{"type":"null"}],"description":"Set while the code is archived; its printed code stops resolving."},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","description":"ISO 8601, UTC, e.g. `2026-10-12T09:30:00.000Z`."},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","description":"ISO 8601, UTC, e.g. `2026-10-12T09:30:00.000Z`."}},"required":["id","slug","url","mode","title","subtitle","destinationUrl","avatarUrl","isActive","tags","archivedAt","createdAt","updatedAt"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}},"security":[{"bearerAuth":[]}]},"patch":{"operationId":"updateLink","tags":["links"],"summary":"Edit a QR code's basics","description":"Title, subtitle, mode, destination and on/off, with the Basics card's rules. The slug never changes. An archived code answers `409 link_archived`.","parameters":[{"name":"id","in":"path","required":true,"description":"The QR code's id.","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"subtitle":{"anyOf":[{"type":"string"},{"type":"null"}]},"mode":{"type":"string","enum":["bio","redirect"]},"destinationUrl":{"description":"Required when the code is, or becomes, a redirect.","anyOf":[{"type":"string"},{"type":"null"}]},"isActive":{"type":"boolean"}},"additionalProperties":false,"description":"Only the fields to change; at least one. Absent keeps the saved value, `null` clears it."}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"slug":{"type":"string","description":"Set once, at creation; the printed code's address never changes."},"url":{"type":"string","format":"uri","description":"The address the QR code encodes."},"mode":{"type":"string","enum":["bio","redirect"]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"subtitle":{"anyOf":[{"type":"string"},{"type":"null"}]},"destinationUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Where a redirect code sends people; null for a bio page."},"avatarUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"isActive":{"type":"boolean"},"tags":{"type":"array","items":{"type":"string"}},"archivedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","description":"ISO 8601, UTC, e.g. `2026-10-12T09:30:00.000Z`."},{"type":"null"}],"description":"Set while the code is archived; its printed code stops resolving."},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","description":"ISO 8601, UTC, e.g. `2026-10-12T09:30:00.000Z`."},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","description":"ISO 8601, UTC, e.g. `2026-10-12T09:30:00.000Z`."}},"required":["id","slug","url","mode","title","subtitle","destinationUrl","avatarUrl","isActive","tags","archivedAt","createdAt","updatedAt"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/PayloadTooLarge"},"415":{"$ref":"#/components/responses/UnsupportedMediaType"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}},"security":[{"bearerAuth":[]}]},"delete":{"operationId":"archiveLink","tags":["links"],"summary":"Archive a QR code","description":"A soft delete: the printed code stops resolving, the code and its analytics stay and it can be restored. Archiving an archived code is fine.","parameters":[{"name":"id","in":"path","required":true,"description":"The QR code's id.","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}},"security":[{"bearerAuth":[]}]}},"/links/{id}/analytics":{"get":{"operationId":"getLinkAnalytics","tags":["analytics"],"summary":"One QR code's analytics","description":"The same picture as the project's, for one code. An archived code answers `404`.","parameters":[{"name":"id","in":"path","required":true,"description":"The QR code's id.","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"range","in":"query","required":false,"description":"The window in days: 7, 30 or 90 (the default).","schema":{"default":"30","type":"string","enum":["7","30","90"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"range":{"anyOf":[{"type":"number","const":7},{"type":"number","const":30},{"type":"number","const":90}],"description":"The window, in days."},"totals":{"type":"object","properties":{"views":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Bio page views."},"clicks":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Button taps."},"redirects":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Redirect code scans."},"visitors":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Distinct visitors."}},"required":["views","clicks","redirects","visitors"],"additionalProperties":false},"previousTotals":{"type":"object","properties":{"views":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Bio page views."},"clicks":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Button taps."},"redirects":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Redirect code scans."},"visitors":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Distinct visitors."}},"required":["views","clicks","redirects","visitors"],"additionalProperties":false,"description":"The same numbers for the window just before."},"series":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","description":"`YYYY-MM-DD`."},"scans":{"type":"integer","minimum":0,"maximum":9007199254740991},"clicks":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["date","scans","clicks"],"additionalProperties":false}},"countries":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["label","value"],"additionalProperties":false}},"devices":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["label","value"],"additionalProperties":false}},"browsers":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["label","value"],"additionalProperties":false}},"languages":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["label","value"],"additionalProperties":false}},"referrers":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["label","value"],"additionalProperties":false}},"services":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["label","value"],"additionalProperties":false},"description":"Taps by the tapped button's service."},"topLinks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"slug":{"type":"string"},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"mode":{"type":"string","enum":["bio","redirect"]},"scans":{"type":"integer","minimum":0,"maximum":9007199254740991},"clicks":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","slug","title","mode","scans","clicks"],"additionalProperties":false}},"recent":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string","enum":["view","click","redirect"]},"slug":{"type":"string"},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"button":{"anyOf":[{"type":"object","properties":{"label":{"type":"string"},"type":{"type":"string"}},"required":["label","type"],"additionalProperties":false},{"type":"null"}],"description":"The tapped button; null for a view or a redirect."},"country":{"anyOf":[{"type":"string"},{"type":"null"}]},"deviceType":{"anyOf":[{"type":"string"},{"type":"null"}]},"browser":{"anyOf":[{"type":"string"},{"type":"null"}]},"ts":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","description":"ISO 8601, UTC, e.g. `2026-10-12T09:30:00.000Z`."}},"required":["id","type","slug","title","button","country","deviceType","browser","ts"],"additionalProperties":false}}},"required":["range","totals","previousTotals","series","countries","devices","browsers","languages","referrers","services","topLinks","recent"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}},"security":[{"bearerAuth":[]}]}},"/links/{id}/analytics/buttons":{"get":{"operationId":"getLinkButtonTaps","tags":["analytics"],"summary":"One bio page's taps per button","description":"Each button's taps in the window against the window before. An archived code answers `404`.","parameters":[{"name":"id","in":"path","required":true,"description":"The QR code's id.","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"range","in":"query","required":false,"description":"The window in days: 7, 30 or 90 (the default).","schema":{"default":"30","type":"string","enum":["7","30","90"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"range":{"anyOf":[{"type":"number","const":7},{"type":"number","const":30},{"type":"number","const":90}],"description":"The window, in days."},"total":{"type":"integer","minimum":0,"maximum":9007199254740991},"live":{"type":"array","items":{"type":"object","properties":{"taps":{"type":"integer","minimum":0,"maximum":9007199254740991},"previousTaps":{"type":"integer","minimum":0,"maximum":9007199254740991},"share":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Whole percent of the page's taps in the window."},"fraction":{"type":"number","minimum":0,"maximum":1},"delta":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["up","down"]},"percent":{"type":"number"}},"required":["kind","percent"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"flat"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"new"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"none"}},"required":["kind"],"additionalProperties":false}]},"button":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string"},"label":{"type":"string"},"value":{"type":"string","description":"Its destination: a link, an address, a number."},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"isActive":{"type":"boolean"},"removedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","description":"ISO 8601, UTC, e.g. `2026-10-12T09:30:00.000Z`."},{"type":"null"}]}},"required":["id","type","label","value","position","isActive","removedAt"],"additionalProperties":false}},"required":["taps","previousTaps","share","fraction","delta","button"],"additionalProperties":false},"description":"Buttons on the page, hidden ones included: most taps first."},"removed":{"type":"array","items":{"type":"object","properties":{"taps":{"type":"integer","minimum":0,"maximum":9007199254740991},"previousTaps":{"type":"integer","minimum":0,"maximum":9007199254740991},"share":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Whole percent of the page's taps in the window."},"fraction":{"type":"number","minimum":0,"maximum":1},"delta":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["up","down"]},"percent":{"type":"number"}},"required":["kind","percent"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"flat"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"new"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"none"}},"required":["kind"],"additionalProperties":false}]},"button":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string"},"label":{"type":"string"},"value":{"type":"string","description":"Its destination: a link, an address, a number."},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"isActive":{"type":"boolean"},"removedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","description":"ISO 8601, UTC, e.g. `2026-10-12T09:30:00.000Z`."},{"type":"null"}]}},"required":["id","type","label","value","position","isActive","removedAt"],"additionalProperties":false}},"required":["taps","previousTaps","share","fraction","delta","button"],"additionalProperties":false},"description":"Buttons removed from the page that still have taps."},"unknown":{"anyOf":[{"type":"object","properties":{"taps":{"type":"integer","minimum":0,"maximum":9007199254740991},"previousTaps":{"type":"integer","minimum":0,"maximum":9007199254740991},"share":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Whole percent of the page's taps in the window."},"fraction":{"type":"number","minimum":0,"maximum":1},"delta":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["up","down"]},"percent":{"type":"number"}},"required":["kind","percent"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"flat"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"new"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"none"}},"required":["kind"],"additionalProperties":false}]}},"required":["taps","previousTaps","share","fraction","delta"],"additionalProperties":false},{"type":"null"}],"description":"Taps of buttons deleted before taps kept their button; null when none."}},"required":["range","total","live","removed","unknown"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}},"security":[{"bearerAuth":[]}]}},"/links/{id}/analytics/placements":{"get":{"operationId":"getLinkPlacementScans","tags":["analytics"],"summary":"One QR code's scans by placement","description":"Scans in the window by printed placement. An archived code answers `404`.","parameters":[{"name":"id","in":"path","required":true,"description":"The QR code's id.","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"range","in":"query","required":false,"description":"The window in days: 7, 30 or 90 (the default).","schema":{"default":"30","type":"string","enum":["7","30","90"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"range":{"anyOf":[{"type":"number","const":7},{"type":"number","const":30},{"type":"number","const":90}],"description":"The window, in days."},"items":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"archived":{"type":"boolean"},"scans":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["label","archived","scans"],"additionalProperties":false},"description":"Default first (scans no placement claims), then each placement; empty for a code with no placements."}},"required":["range","items"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}},"security":[{"bearerAuth":[]}]}},"/links/{id}/blocks":{"get":{"operationId":"listBlocks","tags":["blocks"],"summary":"List a bio page's blocks","description":"The page's buttons, headings, texts and dividers top to bottom (hidden ones included), and the blocks removed from it (which can be restored).","parameters":[{"name":"id","in":"path","required":true,"description":"The QR code's id.","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"blocks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string","enum":["instagram","facebook","tiktok","x","youtube","whatsapp","spotify","email","phone","maps","website","custom","viber","messenger","telegram","signal","whatsappchannel","videocall","threads","pinterest","snapchat","reddit","discord","meetup","twitch","kick","bluesky","tumblr","googlereview","tripadvisor","bookingcom","airbnb","booking","calendly","tickets","form","menu","efood","wolt","box","shop","etsy","vinted","ebay","skroutz","paypal","revolut","viva","donate","soundcloud","applemusic","youtubemusic","deezer","bandcamp","vimeo","applepodcasts","onlyfans","fansly","patreon","kofi","buymeacoffee","substack","gumroad","medium","linkedin","github","behance","dribbble","appstore","googleplay","contact","calendar","header","text","image","gallery","divider","faq","findus","quotes","events","posts","signup"],"description":"The button's service (`instagram`, `whatsapp`, `email`, `website`, …) or `header`, `text`, `image`, `gallery`, `divider`."},"subtype":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A variant of the type, when it has one; usually null."},"label":{"type":"string","description":"The button's text (the service's name when none was given); a heading's or text's content; an image's description; `Gallery` for a gallery."},"value":{"type":"string","description":"Where it leads, as stored: a URL, `mailto:`, `tel:` or `viber://` link; an image's address in this project's uploads (a gallery's first picture's); empty for a heading, text or divider."},"config":{"type":"object","properties":{"message":{"description":"A WhatsApp message.","type":"string"},"subject":{"description":"An email's subject.","type":"string"},"body":{"description":"An email's body.","type":"string"},"text":{"description":"A divider's words, shown in the middle of its line.","type":"string"}},"additionalProperties":false},"width":{"type":"string","enum":["full","half"],"description":"`full`: a line of its own. `half`: shares its line with the block beside it. Set by the layout."},"position":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Its place on the page: top to bottom, left to right."},"isActive":{"type":"boolean","description":"False while it is hidden from the public page."}},"required":["id","type","subtype","label","value","config","width","position","isActive"],"additionalProperties":false}},"removed":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string","enum":["instagram","facebook","tiktok","x","youtube","whatsapp","spotify","email","phone","maps","website","custom","viber","messenger","telegram","signal","whatsappchannel","videocall","threads","pinterest","snapchat","reddit","discord","meetup","twitch","kick","bluesky","tumblr","googlereview","tripadvisor","bookingcom","airbnb","booking","calendly","tickets","form","menu","efood","wolt","box","shop","etsy","vinted","ebay","skroutz","paypal","revolut","viva","donate","soundcloud","applemusic","youtubemusic","deezer","bandcamp","vimeo","applepodcasts","onlyfans","fansly","patreon","kofi","buymeacoffee","substack","gumroad","medium","linkedin","github","behance","dribbble","appstore","googleplay","contact","calendar","header","text","image","gallery","divider","faq","findus","quotes","events","posts","signup"],"description":"The button's service (`instagram`, `whatsapp`, `email`, `website`, …) or `header`, `text`, `image`, `gallery`, `divider`."},"label":{"type":"string"},"value":{"type":"string"},"removedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","description":"ISO 8601, UTC, e.g. `2026-10-12T09:30:00.000Z`."}},"required":["id","type","label","value","removedAt"],"additionalProperties":false},"description":"Blocks removed from the page; each can be restored."}},"required":["blocks","removed"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}},"security":[{"bearerAuth":[]}]},"post":{"operationId":"createBlock","tags":["blocks"],"summary":"Add a block","description":"Adds a button, heading, text, image, gallery or divider at the end of the page, built with the editor's own rules: a bad input answers `validation_failed` with the input's path (`fields.url`, `label`, …; an image whose `fields.url` is not one of this project's uploaded pictures, or whose file is gone, is refused on `fields.url`, and a gallery picture likewise on its own `fields.pictureN`). An archived code answers `409 link_archived`.","parameters":[{"name":"id","in":"path","required":true,"description":"The QR code's id.","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["instagram","facebook","tiktok","x","youtube","whatsapp","spotify","email","phone","maps","website","custom","viber","messenger","telegram","signal","whatsappchannel","videocall","threads","pinterest","snapchat","reddit","discord","meetup","twitch","kick","bluesky","tumblr","googlereview","tripadvisor","bookingcom","airbnb","booking","calendly","tickets","form","menu","efood","wolt","box","shop","etsy","vinted","ebay","skroutz","paypal","revolut","viva","donate","soundcloud","applemusic","youtubemusic","deezer","bandcamp","vimeo","applepodcasts","onlyfans","fansly","patreon","kofi","buymeacoffee","substack","gumroad","medium","linkedin","github","behance","dribbble","appstore","googleplay","contact","calendar","header","text","image","gallery","divider","faq","findus","quotes","events","posts","signup"],"description":"The button's service (`instagram`, `whatsapp`, `email`, `website`, …) or `header`, `text`, `image`, `gallery`, `divider`."},"subtype":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"description":"A variant of the type, when it has one; leave out otherwise."},"label":{"type":"string","maxLength":500,"description":"The button's text (the service's name when left out or blank), a heading's (up to 80 characters) or text's (up to 500) content, or an image's description for people who can't see it (required, up to 200). A gallery ignores it: its pictures are described one by one in `fields`."},"fields":{"default":{},"type":"object","propertyNames":{"type":"string","maxLength":40},"additionalProperties":{"type":"string","maxLength":10000},"description":"The type's inputs by name: `url` (a link, or an @handle for a service with a profile address; for an `image`, the address of one of this project's uploaded pictures, as the editor's library lists them), `phone`, `message` (WhatsApp), `email`, `subject`, `body`, `query` (a place or a Google Maps link), an image's `size` (`full`, `medium`, `small`), `background` (`none`, `card`) and `corners` (`match`, `square`, `circle`), each the first when left out, an image's optional `link` (an `http` or `https` address the whole picture goes to when tapped, counted as a tap like a button's; left empty for none), and a divider's `text` (the words shown in the middle of its line, up to 40 characters; blank or left out for a plain line). A gallery's pictures are `picture1` … `picture12` (each an uploaded picture's address, as for an image) with their descriptions `alt1` … `alt12` (each required, up to 200 characters) and optional links `link1` … `link12` (an `http` or `https` address the picture opens in a new tab when tapped, counted as a tap on the gallery; left empty for none), and its `direction` (`ltr`, `rtl`) and `motion` (`swipe`, `auto`), the first when left out. An \"Add to calendar\" button's (`calendar`) event is `eventName` (required, up to 120 characters), `startDate` (`YYYY-MM-DD`, required), `startTime` (`HH:MM`; left out for an all-day event), `endDate` and `endTime` (no end time lasts one hour; an end on another day needs both), `location` (up to 160), `details` (up to 1000, line breaks kept) and `eventUrl` (an `http` or `https` address), its times on the project's time zone. Names the type has no input for are ignored."}},"required":["type"],"additionalProperties":false}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string","enum":["instagram","facebook","tiktok","x","youtube","whatsapp","spotify","email","phone","maps","website","custom","viber","messenger","telegram","signal","whatsappchannel","videocall","threads","pinterest","snapchat","reddit","discord","meetup","twitch","kick","bluesky","tumblr","googlereview","tripadvisor","bookingcom","airbnb","booking","calendly","tickets","form","menu","efood","wolt","box","shop","etsy","vinted","ebay","skroutz","paypal","revolut","viva","donate","soundcloud","applemusic","youtubemusic","deezer","bandcamp","vimeo","applepodcasts","onlyfans","fansly","patreon","kofi","buymeacoffee","substack","gumroad","medium","linkedin","github","behance","dribbble","appstore","googleplay","contact","calendar","header","text","image","gallery","divider","faq","findus","quotes","events","posts","signup"],"description":"The button's service (`instagram`, `whatsapp`, `email`, `website`, …) or `header`, `text`, `image`, `gallery`, `divider`."},"subtype":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A variant of the type, when it has one; usually null."},"label":{"type":"string","description":"The button's text (the service's name when none was given); a heading's or text's content; an image's description; `Gallery` for a gallery."},"value":{"type":"string","description":"Where it leads, as stored: a URL, `mailto:`, `tel:` or `viber://` link; an image's address in this project's uploads (a gallery's first picture's); empty for a heading, text or divider."},"config":{"type":"object","properties":{"message":{"description":"A WhatsApp message.","type":"string"},"subject":{"description":"An email's subject.","type":"string"},"body":{"description":"An email's body.","type":"string"},"text":{"description":"A divider's words, shown in the middle of its line.","type":"string"}},"additionalProperties":false},"width":{"type":"string","enum":["full","half"],"description":"`full`: a line of its own. `half`: shares its line with the block beside it. Set by the layout."},"position":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Its place on the page: top to bottom, left to right."},"isActive":{"type":"boolean","description":"False while it is hidden from the public page."}},"required":["id","type","subtype","label","value","config","width","position","isActive"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/PayloadTooLarge"},"415":{"$ref":"#/components/responses/UnsupportedMediaType"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}},"security":[{"bearerAuth":[]}]}},"/links/{id}/blocks/{blockId}":{"patch":{"operationId":"updateBlock","tags":["blocks"],"summary":"Edit a block","description":"Its label, inputs, variant or visibility, with the editor's rules; its width is kept. A removed block answers `404`.","parameters":[{"name":"id","in":"path","required":true,"description":"The QR code's id.","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"blockId","in":"path","required":true,"description":"The block's id.","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"subtype":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"description":"A variant of the type, when it has one; leave out otherwise."},"label":{"type":"string","maxLength":500,"description":"The button's text (the service's name when left out or blank), a heading's (up to 80 characters) or text's (up to 500) content, or an image's description for people who can't see it (required, up to 200). A gallery ignores it: its pictures are described one by one in `fields`."},"fields":{"type":"object","propertyNames":{"type":"string","maxLength":40},"additionalProperties":{"type":"string","maxLength":10000},"description":"The type's inputs by name: `url` (a link, or an @handle for a service with a profile address; for an `image`, the address of one of this project's uploaded pictures, as the editor's library lists them), `phone`, `message` (WhatsApp), `email`, `subject`, `body`, `query` (a place or a Google Maps link), an image's `size` (`full`, `medium`, `small`), `background` (`none`, `card`) and `corners` (`match`, `square`, `circle`), each the first when left out, an image's optional `link` (an `http` or `https` address the whole picture goes to when tapped, counted as a tap like a button's; left empty for none), and a divider's `text` (the words shown in the middle of its line, up to 40 characters; blank or left out for a plain line). A gallery's pictures are `picture1` … `picture12` (each an uploaded picture's address, as for an image) with their descriptions `alt1` … `alt12` (each required, up to 200 characters) and optional links `link1` … `link12` (an `http` or `https` address the picture opens in a new tab when tapped, counted as a tap on the gallery; left empty for none), and its `direction` (`ltr`, `rtl`) and `motion` (`swipe`, `auto`), the first when left out. An \"Add to calendar\" button's (`calendar`) event is `eventName` (required, up to 120 characters), `startDate` (`YYYY-MM-DD`, required), `startTime` (`HH:MM`; left out for an all-day event), `endDate` and `endTime` (no end time lasts one hour; an end on another day needs both), `location` (up to 160), `details` (up to 1000, line breaks kept) and `eventUrl` (an `http` or `https` address), its times on the project's time zone. Names the type has no input for are ignored."},"isActive":{"description":"Show (`true`) or hide (`false`) it on the public page.","type":"boolean"}},"additionalProperties":false,"description":"Only the fields to change; at least one. An input left out keeps its saved value. The type never changes; the width is the layout's."}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string","enum":["instagram","facebook","tiktok","x","youtube","whatsapp","spotify","email","phone","maps","website","custom","viber","messenger","telegram","signal","whatsappchannel","videocall","threads","pinterest","snapchat","reddit","discord","meetup","twitch","kick","bluesky","tumblr","googlereview","tripadvisor","bookingcom","airbnb","booking","calendly","tickets","form","menu","efood","wolt","box","shop","etsy","vinted","ebay","skroutz","paypal","revolut","viva","donate","soundcloud","applemusic","youtubemusic","deezer","bandcamp","vimeo","applepodcasts","onlyfans","fansly","patreon","kofi","buymeacoffee","substack","gumroad","medium","linkedin","github","behance","dribbble","appstore","googleplay","contact","calendar","header","text","image","gallery","divider","faq","findus","quotes","events","posts","signup"],"description":"The button's service (`instagram`, `whatsapp`, `email`, `website`, …) or `header`, `text`, `image`, `gallery`, `divider`."},"subtype":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A variant of the type, when it has one; usually null."},"label":{"type":"string","description":"The button's text (the service's name when none was given); a heading's or text's content; an image's description; `Gallery` for a gallery."},"value":{"type":"string","description":"Where it leads, as stored: a URL, `mailto:`, `tel:` or `viber://` link; an image's address in this project's uploads (a gallery's first picture's); empty for a heading, text or divider."},"config":{"type":"object","properties":{"message":{"description":"A WhatsApp message.","type":"string"},"subject":{"description":"An email's subject.","type":"string"},"body":{"description":"An email's body.","type":"string"},"text":{"description":"A divider's words, shown in the middle of its line.","type":"string"}},"additionalProperties":false},"width":{"type":"string","enum":["full","half"],"description":"`full`: a line of its own. `half`: shares its line with the block beside it. Set by the layout."},"position":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Its place on the page: top to bottom, left to right."},"isActive":{"type":"boolean","description":"False while it is hidden from the public page."}},"required":["id","type","subtype","label","value","config","width","position","isActive"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/PayloadTooLarge"},"415":{"$ref":"#/components/responses/UnsupportedMediaType"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}},"security":[{"bearerAuth":[]}]},"delete":{"operationId":"removeBlock","tags":["blocks"],"summary":"Remove a block","description":"Takes it off the page and lists it under `removed`: its taps keep their history and it can be restored. The block beside it, if any, gets the line to itself. A block already removed answers `404`.","parameters":[{"name":"id","in":"path","required":true,"description":"The QR code's id.","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"blockId","in":"path","required":true,"description":"The block's id.","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}},"security":[{"bearerAuth":[]}]}},"/links/{id}/blocks/{blockId}/restore":{"post":{"operationId":"restoreBlock","tags":["blocks"],"summary":"Restore a removed block","description":"Brings a removed block back, hidden, at the end of the page and on a line of its own, so the public page is unchanged until it is shown. A block that is not removed, or a page with no room, answers `409 conflict`.","parameters":[{"name":"id","in":"path","required":true,"description":"The QR code's id.","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"blockId","in":"path","required":true,"description":"The block's id.","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string","enum":["instagram","facebook","tiktok","x","youtube","whatsapp","spotify","email","phone","maps","website","custom","viber","messenger","telegram","signal","whatsappchannel","videocall","threads","pinterest","snapchat","reddit","discord","meetup","twitch","kick","bluesky","tumblr","googlereview","tripadvisor","bookingcom","airbnb","booking","calendly","tickets","form","menu","efood","wolt","box","shop","etsy","vinted","ebay","skroutz","paypal","revolut","viva","donate","soundcloud","applemusic","youtubemusic","deezer","bandcamp","vimeo","applepodcasts","onlyfans","fansly","patreon","kofi","buymeacoffee","substack","gumroad","medium","linkedin","github","behance","dribbble","appstore","googleplay","contact","calendar","header","text","image","gallery","divider","faq","findus","quotes","events","posts","signup"],"description":"The button's service (`instagram`, `whatsapp`, `email`, `website`, …) or `header`, `text`, `image`, `gallery`, `divider`."},"subtype":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A variant of the type, when it has one; usually null."},"label":{"type":"string","description":"The button's text (the service's name when none was given); a heading's or text's content; an image's description; `Gallery` for a gallery."},"value":{"type":"string","description":"Where it leads, as stored: a URL, `mailto:`, `tel:` or `viber://` link; an image's address in this project's uploads (a gallery's first picture's); empty for a heading, text or divider."},"config":{"type":"object","properties":{"message":{"description":"A WhatsApp message.","type":"string"},"subject":{"description":"An email's subject.","type":"string"},"body":{"description":"An email's body.","type":"string"},"text":{"description":"A divider's words, shown in the middle of its line.","type":"string"}},"additionalProperties":false},"width":{"type":"string","enum":["full","half"],"description":"`full`: a line of its own. `half`: shares its line with the block beside it. Set by the layout."},"position":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Its place on the page: top to bottom, left to right."},"isActive":{"type":"boolean","description":"False while it is hidden from the public page."}},"required":["id","type","subtype","label","value","config","width","position","isActive"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}},"security":[{"bearerAuth":[]}]}},"/links/{id}/blocks/layout":{"put":{"operationId":"replaceBlockLayout","tags":["blocks"],"summary":"Set the page's layout","description":"The order of the page's blocks and which two share a line, as the editor's arrows and drag save it. The lines must hold exactly the page's blocks (hidden ones included, removed ones left out), each once, or nothing changes (`validation_failed` on `lines`).","parameters":[{"name":"id","in":"path","required":true,"description":"The QR code's id.","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"lines":{"maxItems":200,"type":"array","items":{"anyOf":[{"type":"array","prefixItems":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}]},{"type":"array","prefixItems":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}]}]},"description":"Every block on the page once, top to bottom: `[id]` for a line of its own, `[left, right]` for two side by side (two buttons, or two images). A heading, text, gallery or divider is always a line of its own; removed blocks are left out."}},"required":["lines"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"blocks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string","enum":["instagram","facebook","tiktok","x","youtube","whatsapp","spotify","email","phone","maps","website","custom","viber","messenger","telegram","signal","whatsappchannel","videocall","threads","pinterest","snapchat","reddit","discord","meetup","twitch","kick","bluesky","tumblr","googlereview","tripadvisor","bookingcom","airbnb","booking","calendly","tickets","form","menu","efood","wolt","box","shop","etsy","vinted","ebay","skroutz","paypal","revolut","viva","donate","soundcloud","applemusic","youtubemusic","deezer","bandcamp","vimeo","applepodcasts","onlyfans","fansly","patreon","kofi","buymeacoffee","substack","gumroad","medium","linkedin","github","behance","dribbble","appstore","googleplay","contact","calendar","header","text","image","gallery","divider","faq","findus","quotes","events","posts","signup"],"description":"The button's service (`instagram`, `whatsapp`, `email`, `website`, …) or `header`, `text`, `image`, `gallery`, `divider`."},"subtype":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"A variant of the type, when it has one; usually null."},"label":{"type":"string","description":"The button's text (the service's name when none was given); a heading's or text's content; an image's description; `Gallery` for a gallery."},"value":{"type":"string","description":"Where it leads, as stored: a URL, `mailto:`, `tel:` or `viber://` link; an image's address in this project's uploads (a gallery's first picture's); empty for a heading, text or divider."},"config":{"type":"object","properties":{"message":{"description":"A WhatsApp message.","type":"string"},"subject":{"description":"An email's subject.","type":"string"},"body":{"description":"An email's body.","type":"string"},"text":{"description":"A divider's words, shown in the middle of its line.","type":"string"}},"additionalProperties":false},"width":{"type":"string","enum":["full","half"],"description":"`full`: a line of its own. `half`: shares its line with the block beside it. Set by the layout."},"position":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Its place on the page: top to bottom, left to right."},"isActive":{"type":"boolean","description":"False while it is hidden from the public page."}},"required":["id","type","subtype","label","value","config","width","position","isActive"],"additionalProperties":false}}},"required":["blocks"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/PayloadTooLarge"},"415":{"$ref":"#/components/responses/UnsupportedMediaType"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}},"security":[{"bearerAuth":[]}]}},"/links/{id}/placements":{"get":{"operationId":"listPlacements","tags":["placements"],"summary":"List a QR code's placements","description":"The live placements with their scans in the last 30 days, as the Advanced → Placements card shows them. Archived placements are left out.","parameters":[{"name":"id","in":"path","required":true,"description":"The QR code's id.","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"placements":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"label":{"type":"string"},"code":{"type":"string","description":"The short code in its address (`?p=`); printed, so it never changes."},"url":{"type":"string","format":"uri","description":"The address this placement's QR code encodes: the code's own plus `?p=`."},"scans":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Scans in the last 30 days."}},"required":["id","label","code","url","scans"],"additionalProperties":false}}},"required":["placements"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}},"security":[{"bearerAuth":[]}]},"post":{"operationId":"createPlacement","tags":["placements"],"summary":"Add a placement","description":"A new printed placement of the code, named; its code and address are made here. A name a live placement already has, or a 21th live placement, answers `409 conflict`. An archived code answers `409 link_archived`.","parameters":[{"name":"id","in":"path","required":true,"description":"The QR code's id.","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"label":{"description":"What the owner calls it (\"Shop window\"): 1 to 40 characters once cleaned, not \"Default\", and not the name of another live placement of the code.","type":"string","maxLength":500}},"required":["label"],"additionalProperties":false}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"label":{"type":"string"},"code":{"type":"string","description":"The short code in its address (`?p=`); printed, so it never changes."},"url":{"type":"string","format":"uri","description":"The address this placement's QR code encodes: the code's own plus `?p=`."},"scans":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Scans in the last 30 days."}},"required":["id","label","code","url","scans"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/PayloadTooLarge"},"415":{"$ref":"#/components/responses/UnsupportedMediaType"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}},"security":[{"bearerAuth":[]}]}},"/links/{id}/placements/{placementId}/archive":{"post":{"operationId":"archivePlacement","tags":["placements"],"summary":"Archive a placement","description":"Its printed code then counts as Default; its history stays. Archiving an archived placement answers the same.","parameters":[{"name":"id","in":"path","required":true,"description":"The QR code's id.","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"placementId","in":"path","required":true,"description":"The placement's id.","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","const":true}},"required":["ok"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}},"security":[{"bearerAuth":[]}]}},"/links/{id}/qr":{"get":{"operationId":"getLinkQr","tags":["qr"],"summary":"Read a QR code's style","description":"The address the code encodes and its saved style.","parameters":[{"name":"id","in":"path","required":true,"description":"The QR code's id.","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"The address the QR code encodes."},"config":{"type":"object","properties":{"dotsType":{"type":"string","enum":["square","rounded","dots","classy","classy-rounded","extra-rounded"]},"dotsColor":{"type":"string"},"cornersSquareType":{"type":"string","enum":["square","dot","extra-rounded","rounded","classy","classy-rounded"]},"cornersSquareColor":{"type":"string"},"cornersDotType":{"type":"string","enum":["square","dot","rounded","extra-rounded","classy","classy-rounded","dots"]},"cornersDotColor":{"type":"string"},"backgroundColor":{"description":"A colour, or `transparent`.","type":"string"},"errorCorrectionLevel":{"type":"string","enum":["L","M","Q","H"]},"imageUrl":{"description":"The centre logo picture.","type":"string"},"logo":{"type":"object","properties":{"enabled":{"type":"boolean"},"size":{"type":"string","enum":["small","medium","large"]},"spacing":{"type":"string","enum":["none","tight","normal","roomy"]},"hideDots":{"type":"boolean"},"shape":{"type":"string","enum":["original","circle","rounded"]},"plate":{"type":"string","enum":["none","paper","custom"]},"plateColor":{"type":"string","maxLength":64}},"required":["enabled","size","spacing","hideDots"],"additionalProperties":false},"frame":{"type":"object","properties":{"enabled":{"type":"boolean"},"style":{"type":"string","enum":["label-below","label-above","bubble","badge","caption"]},"text":{"type":"string"},"color":{"type":"string"},"textColor":{"type":"string"}},"required":["enabled","style","text"],"additionalProperties":false},"openInApp":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"],"additionalProperties":false}},"additionalProperties":false,"description":"The saved style: dots, corners, colours, error correction and centre image, plus the Advanced sections `logo`, `frame` and `openInApp` when set."}},"required":["url","config"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}},"security":[{"bearerAuth":[]}]},"patch":{"operationId":"updateLinkQr","tags":["qr"],"summary":"Change a QR code's style","description":"Replaces the parts sent (the QR tab's style, the centre logo, the frame, open in app) and keeps the rest. The address never changes. An archived code answers `409 link_archived`.","parameters":[{"name":"id","in":"path","required":true,"description":"The QR code's id.","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"style":{"description":"The QR tab's settings, whole: dots, corners, colours, error correction, centre image.","type":"object","properties":{"dotsType":{"type":"string","enum":["square","rounded","dots","classy","classy-rounded","extra-rounded"]},"dotsColor":{"type":"string","maxLength":64},"cornersSquareType":{"type":"string","enum":["square","dot","extra-rounded","rounded","classy","classy-rounded"]},"cornersSquareColor":{"type":"string","maxLength":64},"cornersDotType":{"type":"string","enum":["square","dot","rounded","extra-rounded"]},"cornersDotColor":{"type":"string","maxLength":64},"backgroundColor":{"type":"string","maxLength":64},"errorCorrectionLevel":{"type":"string","enum":["L","M","Q","H"]},"imageUrl":{"type":"string","format":"uri"}},"additionalProperties":false},"logo":{"description":"Advanced → Centre logo.","type":"object","properties":{"enabled":{"type":"boolean"},"size":{"type":"string","enum":["small","medium","large"]},"spacing":{"type":"string","enum":["none","tight","normal","roomy"]},"hideDots":{"type":"boolean"},"shape":{"type":"string","enum":["original","circle","rounded"]},"plate":{"type":"string","enum":["none","paper","custom"]},"plateColor":{"type":"string","maxLength":64}},"required":["enabled","size","spacing","hideDots"],"additionalProperties":false},"frame":{"description":"Advanced → Frame; `text` is 1 to 24 letters, digits, spaces or simple punctuation.","type":"object","properties":{"enabled":{"type":"boolean"},"style":{"type":"string","enum":["label-below","label-above","bubble","badge","caption"]},"text":{"type":"string","maxLength":200},"color":{"type":"string","maxLength":64},"textColor":{"type":"string","maxLength":64}},"required":["enabled","style","text"],"additionalProperties":false},"openInApp":{"description":"Advanced → Open in app (redirect codes).","type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"],"additionalProperties":false}},"additionalProperties":false,"description":"Any of `style`, `logo`, `frame`, `openInApp`; at least one. Each replaces that part whole; the others stay as saved."}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"The address the QR code encodes."},"config":{"type":"object","properties":{"dotsType":{"type":"string","enum":["square","rounded","dots","classy","classy-rounded","extra-rounded"]},"dotsColor":{"type":"string"},"cornersSquareType":{"type":"string","enum":["square","dot","extra-rounded","rounded","classy","classy-rounded"]},"cornersSquareColor":{"type":"string"},"cornersDotType":{"type":"string","enum":["square","dot","rounded","extra-rounded","classy","classy-rounded","dots"]},"cornersDotColor":{"type":"string"},"backgroundColor":{"description":"A colour, or `transparent`.","type":"string"},"errorCorrectionLevel":{"type":"string","enum":["L","M","Q","H"]},"imageUrl":{"description":"The centre logo picture.","type":"string"},"logo":{"type":"object","properties":{"enabled":{"type":"boolean"},"size":{"type":"string","enum":["small","medium","large"]},"spacing":{"type":"string","enum":["none","tight","normal","roomy"]},"hideDots":{"type":"boolean"},"shape":{"type":"string","enum":["original","circle","rounded"]},"plate":{"type":"string","enum":["none","paper","custom"]},"plateColor":{"type":"string","maxLength":64}},"required":["enabled","size","spacing","hideDots"],"additionalProperties":false},"frame":{"type":"object","properties":{"enabled":{"type":"boolean"},"style":{"type":"string","enum":["label-below","label-above","bubble","badge","caption"]},"text":{"type":"string"},"color":{"type":"string"},"textColor":{"type":"string"}},"required":["enabled","style","text"],"additionalProperties":false},"openInApp":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"],"additionalProperties":false}},"additionalProperties":false,"description":"The saved style: dots, corners, colours, error correction and centre image, plus the Advanced sections `logo`, `frame` and `openInApp` when set."}},"required":["url","config"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/PayloadTooLarge"},"415":{"$ref":"#/components/responses/UnsupportedMediaType"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}},"security":[{"bearerAuth":[]}]}},"/links/{id}/restore":{"post":{"operationId":"restoreLink","tags":["links"],"summary":"Restore an archived QR code","description":"Brings an archived code back; its printed code resolves again. A live code answers `409 conflict`.","parameters":[{"name":"id","in":"path","required":true,"description":"The QR code's id.","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"slug":{"type":"string","description":"Set once, at creation; the printed code's address never changes."},"url":{"type":"string","format":"uri","description":"The address the QR code encodes."},"mode":{"type":"string","enum":["bio","redirect"]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"subtitle":{"anyOf":[{"type":"string"},{"type":"null"}]},"destinationUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Where a redirect code sends people; null for a bio page."},"avatarUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"isActive":{"type":"boolean"},"tags":{"type":"array","items":{"type":"string"}},"archivedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","description":"ISO 8601, UTC, e.g. `2026-10-12T09:30:00.000Z`."},{"type":"null"}],"description":"Set while the code is archived; its printed code stops resolving."},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","description":"ISO 8601, UTC, e.g. `2026-10-12T09:30:00.000Z`."},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","description":"ISO 8601, UTC, e.g. `2026-10-12T09:30:00.000Z`."}},"required":["id","slug","url","mode","title","subtitle","destinationUrl","avatarUrl","isActive","tags","archivedAt","createdAt","updatedAt"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}},"security":[{"bearerAuth":[]}]}},"/links/{id}/tags":{"put":{"operationId":"replaceLinkTags","tags":["tags"],"summary":"Replace a QR code's tags","description":"Saves the list whole; the answer is the list as stored. An archived code answers `409 link_archived`.","parameters":[{"name":"id","in":"path","required":true,"description":"The QR code's id.","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tags":{"description":"At most 8, each up to 24 characters: letters, digits, spaces and dashes, stored in lower case. Repeats are dropped, order kept.","maxItems":8,"type":"array","items":{"type":"string","maxLength":200}}},"required":["tags"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tags":{"type":"array","items":{"type":"string"}}},"required":["tags"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/PayloadTooLarge"},"415":{"$ref":"#/components/responses/UnsupportedMediaType"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}},"security":[{"bearerAuth":[]}]}},"/links/{id}/theme":{"get":{"operationId":"getLinkTheme","tags":["theme"],"summary":"Read a bio page's look","description":"The saved theme; `{}` for a page that keeps the default look.","parameters":[{"name":"id","in":"path","required":true,"description":"The QR code's id.","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"background":{"type":"object","properties":{"type":{"type":"string","enum":["solid","gradient","image","pattern"]},"color":{"type":"string","maxLength":64},"gradient":{"type":"object","properties":{"from":{"type":"string","maxLength":64},"to":{"type":"string","maxLength":64},"angle":{"type":"number","minimum":0,"maximum":360}},"required":["from","to"],"additionalProperties":false},"imageUrl":{"type":"string","format":"uri"},"pattern":{"type":"object","properties":{"emojis":{"minItems":1,"maxItems":12,"type":"array","items":{"type":"string","minLength":1,"maxLength":8}},"size":{"type":"number","minimum":8,"maximum":96},"gap":{"type":"number","minimum":0,"maximum":160},"opacity":{"type":"number","minimum":0,"maximum":1},"color":{"type":"string","maxLength":64}},"required":["emojis"],"additionalProperties":false}},"required":["type"],"additionalProperties":false},"headerImageUrl":{"type":"string","format":"uri"},"avatar":{"type":"object","properties":{"color":{"type":"string","maxLength":64}},"additionalProperties":false},"titleColor":{"type":"string","maxLength":64},"subtitleColor":{"type":"string","maxLength":64},"button":{"type":"object","properties":{"style":{"type":"string","enum":["filled","outline","soft"]},"shape":{"type":"string","enum":["rounded","pill","square"]},"color":{"type":"string","maxLength":64},"textColor":{"type":"string","maxLength":64}},"additionalProperties":false},"fonts":{"type":"object","properties":{"page":{"type":"string","enum":["manrope","commissioner","geologica","comfortaa","playpen-sans","arima","eb-garamond","literata","noto-serif-display","syne","roboto-slab","advent-pro"]},"title":{"type":"string","enum":["manrope","commissioner","geologica","comfortaa","playpen-sans","arima","eb-garamond","literata","noto-serif-display","syne","roboto-slab","advent-pro"]},"subtitle":{"type":"string","enum":["manrope","commissioner","geologica","comfortaa","playpen-sans","arima","eb-garamond","literata","noto-serif-display","syne","roboto-slab","advent-pro"]},"button":{"type":"string","enum":["manrope","commissioner","geologica","comfortaa","playpen-sans","arima","eb-garamond","literata","noto-serif-display","syne","roboto-slab","advent-pro"]}},"additionalProperties":false},"business":{"type":"object","properties":{"enabled":{"type":"boolean"},"kind":{"type":"string","enum":["restaurant","cafe","shop","salon","other"]},"name":{"type":"string","maxLength":100},"street":{"type":"string","maxLength":120},"town":{"type":"string","maxLength":60},"postcode":{"type":"string","maxLength":12,"pattern":"^[\\p{L}\\p{N}][\\p{L}\\p{N} -]*$"},"country":{"type":"string","enum":["GR","CY","AL","AU","AT","BE","BG","CA","HR","CZ","DK","EE","FI","FR","DE","HU","IE","IT","LV","LT","LU","MT","NL","MK","NO","PL","PT","RO","RS","SK","SI","ES","SE","CH","TR","GB","US"]},"phone":{"type":"string","maxLength":32},"website":{"type":"string","maxLength":2048},"hours":{"type":"object","properties":{"mo":{"maxItems":2,"type":"array","items":{"type":"object","properties":{"opens":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"},"closes":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"}},"required":["opens","closes"],"additionalProperties":false}},"tu":{"maxItems":2,"type":"array","items":{"type":"object","properties":{"opens":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"},"closes":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"}},"required":["opens","closes"],"additionalProperties":false}},"we":{"maxItems":2,"type":"array","items":{"type":"object","properties":{"opens":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"},"closes":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"}},"required":["opens","closes"],"additionalProperties":false}},"th":{"maxItems":2,"type":"array","items":{"type":"object","properties":{"opens":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"},"closes":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"}},"required":["opens","closes"],"additionalProperties":false}},"fr":{"maxItems":2,"type":"array","items":{"type":"object","properties":{"opens":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"},"closes":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"}},"required":["opens","closes"],"additionalProperties":false}},"sa":{"maxItems":2,"type":"array","items":{"type":"object","properties":{"opens":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"},"closes":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"}},"required":["opens","closes"],"additionalProperties":false}},"su":{"maxItems":2,"type":"array","items":{"type":"object","properties":{"opens":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"},"closes":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"}},"required":["opens","closes"],"additionalProperties":false}}},"additionalProperties":false}},"required":["enabled","kind","name"],"additionalProperties":false,"description":"Advanced → Show up on Google: the business details published as search-friendly page data. Kept as stored by a save of the look; changed only in the link editor."},"a11y":{"type":"object","properties":{"enabled":{"type":"boolean"},"lang":{"type":"string","enum":["el","en","de","fr","it","es","nl"]},"reading":{"type":"boolean"}},"required":["enabled"],"additionalProperties":false},"poll":{"type":"object","properties":{"enabled":{"type":"boolean"},"question":{"type":"string","maxLength":120},"answers":{"minItems":2,"maxItems":4,"type":"array","items":{"type":"string","maxLength":60}},"after":{"type":"string","enum":["results","thanks"]},"round":{"type":"integer","minimum":1,"maximum":1000000}},"required":["enabled","question","answers","after","round"],"additionalProperties":false,"description":"Advanced → Poll: one question with two to four answers shown on the page, and its round. Kept as stored by a save of the look; changed only in the link editor."},"languages":{"type":"object","properties":{"enabled":{"type":"boolean"},"second":{"type":"string","enum":["el","en"]},"title":{"type":"string","maxLength":1000},"subtitle":{"type":"string","maxLength":1000},"blocks":{"type":"object","propertyNames":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"additionalProperties":{"type":"string","maxLength":2000}}},"required":["enabled","second"],"additionalProperties":false},"iconRow":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"],"additionalProperties":false,"description":"Advanced → Icon row: whether buttons set to show as a small icon are drawn in a row of icons under the title. Kept as stored by a save of the look; changed only in the link editor."},"highlight":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"],"additionalProperties":false,"description":"Advanced → Highlight a button: whether the one button set to pulse, shine or wiggle moves when the page opens. Kept as stored by a save of the look; changed only in the link editor."},"notice":{"type":"object","properties":{"enabled":{"type":"boolean"},"text":{"type":"string","maxLength":120},"url":{"type":"string"},"color":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"from":{"type":"string"},"until":{"type":"string"},"timeZone":{"type":"string","maxLength":64}},"required":["enabled","text"],"additionalProperties":false,"description":"Advanced → Notice at the top: one short line across the top of the page, with an optional link, colour and first and last days (read in the project's time zone). Kept as stored by a save of the look; changed only in the link editor."},"share":{"type":"object","properties":{"enabled":{"type":"boolean"},"placement":{"type":"string","enum":["top","bottom"]},"actions":{"minItems":1,"maxItems":4,"type":"array","items":{"type":"string","enum":["system","copy","whatsapp","viber"]}},"text":{"type":"string","minLength":1,"maxLength":120}},"required":["enabled","placement","actions"],"additionalProperties":false,"description":"Advanced → Share button: a button on the page that shares the page's own address (the phone's share sheet, copy link, WhatsApp, Viber), at the top or the bottom, with optional words sent along. Kept as stored by a save of the look; changed only in the link editor."},"about":{"type":"object","properties":{"enabled":{"type":"boolean"},"since":{"type":"boolean","const":true},"text":{"type":"string","minLength":1,"maxLength":280},"website":{"type":"string"},"where":{"type":"string","minLength":1,"maxLength":120}},"required":["enabled"],"additionalProperties":false,"description":"Advanced → About this page (PRO): a small About link that opens a sheet with only the facts the owner ticked (a short text, since which month the page exists, an official website, where to find them). Kept as stored by a save of the look; changed only in the link editor."},"schedule":{"type":"object","properties":{"enabled":{"type":"boolean"},"from":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"until":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"fallback":{"type":"string","enum":["message","url"]},"url":{"type":"string"},"timeZone":{"type":"string","maxLength":64}},"required":["enabled","fallback"],"additionalProperties":false,"description":"Advanced → Schedule: when the link works (an optional start and end, UTC instants) and what a scan outside that window gets (a short message or another http/https address). Kept as stored by a save of the look; changed only in the link editor."},"buttonPictures":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"],"additionalProperties":false,"description":"Advanced → Button pictures: the switch (off by default) that lets buttons carry a picture. Kept as stored by a save of the look; changed only in the link editor."},"buttonSchedules":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"],"additionalProperties":false,"description":"Advanced → Button schedules: the switch (off by default) that lets a button show only between two dates. Kept as stored by a save of the look; changed only in the link editor."},"buttonGroups":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"],"additionalProperties":false,"description":"Advanced → Button groups: the switch (off by default) that lets a heading show the buttons under it as a section that opens on tap or as a grid (each heading's choice is its block's `groupLayout`). Kept as stored by a save of the look; changed only in the link editor."},"redirectRules":{"type":"object","properties":{"enabled":{"type":"boolean"},"rules":{"maxItems":10,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9-]{1,36}$"},"when":{"type":"object","properties":{"device":{"minItems":1,"maxItems":3,"type":"array","items":{"type":"string","enum":["phone","tablet","desktop"]}},"os":{"minItems":1,"maxItems":5,"type":"array","items":{"type":"string","enum":["ios","android","windows","macos","linux"]}},"country":{"minItems":1,"maxItems":30,"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"}},"language":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"string","pattern":"^[a-z]{2,3}$"}},"time":{"type":"object","properties":{"days":{"minItems":1,"maxItems":7,"type":"array","items":{"type":"integer","minimum":1,"maximum":7}},"from":{"type":"string","maxLength":5},"to":{"type":"string","maxLength":5}},"required":["days"],"additionalProperties":false}},"additionalProperties":false},"url":{"type":"string"}},"required":["id","when","url"],"additionalProperties":false}},"timeZone":{"type":"string","maxLength":64}},"required":["enabled","rules"],"additionalProperties":false,"description":"Advanced → Redirect rules (redirect links only): up to 10 rules, tried top to bottom, each sending a scan that matches all its conditions (device, system, country, language, days and hours in the project's time zone) to its own http/https address; no match goes to the link's destination. Kept as stored by a save of the look; changed only in the link editor."},"header":{"type":"object","properties":{"enabled":{"type":"boolean"},"layout":{"type":"string","enum":["classic","hero"]},"showAvatar":{"type":"boolean"},"logoUrl":{"type":"string"}},"required":["enabled","layout"],"additionalProperties":false,"description":"Advanced → Header style: the page's header as a full-width hero photo (the header banner, with the title on a dark fade) and/or the brand's logo in place of the typed title. Kept as stored by a save of the look; changed only in the link editor."},"footer":{"type":"object","properties":{"enabled":{"type":"boolean"},"mode":{"type":"string","enum":["hide","words"]},"text":{"type":"string","minLength":1,"maxLength":80},"url":{"type":"string"}},"required":["enabled","mode"],"additionalProperties":false,"description":"Advanced → Footer: hides the \"Powered by\" line at the bottom of the page, or replaces it with a short line of the owner's own words and an optional http/https link. Kept as stored by a save of the look; changed only in the link editor."},"buttonLocks":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"],"additionalProperties":false,"description":"Advanced → Lock a button: the switch (off by default) that lets a button ask \"I'm 18 or older\", show a sensitive-content warning, or ask for a code before it opens (each button's lock is its block's `lock`; a code is stored only as a salted hash and never returned). Kept as stored by a save of the look; changed only in the link editor."},"signupForm":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"],"additionalProperties":false,"description":"Advanced → Sign-up form (PRO): the switch (off by default) that lets the page carry Sign-up form blocks, which collect visitors' email addresses with their consent. Kept as stored by a save of the look; changed only in the link editor."}},"additionalProperties":false,"description":"The bio page's look: background, header image, avatar colour, text and button colours, fonts, the accessibility settings and the second-language words (Advanced → Languages). Image addresses must be `http(s)`."}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}},"security":[{"bearerAuth":[]}]},"put":{"operationId":"replaceLinkTheme","tags":["theme"],"summary":"Replace a bio page's look","description":"Saves the theme whole, as the Appearance tab does. The avatar colour, the accessibility settings and the second-language words stay as stored whatever the body says; the answer is the theme as saved. An archived code answers `409 link_archived`.","parameters":[{"name":"id","in":"path","required":true,"description":"The QR code's id.","schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"background":{"type":"object","properties":{"type":{"type":"string","enum":["solid","gradient","image","pattern"]},"color":{"type":"string","maxLength":64},"gradient":{"type":"object","properties":{"from":{"type":"string","maxLength":64},"to":{"type":"string","maxLength":64},"angle":{"type":"number","minimum":0,"maximum":360}},"required":["from","to"]},"imageUrl":{"type":"string","format":"uri"},"pattern":{"type":"object","properties":{"emojis":{"minItems":1,"maxItems":12,"type":"array","items":{"type":"string","minLength":1,"maxLength":8}},"size":{"type":"number","minimum":8,"maximum":96},"gap":{"type":"number","minimum":0,"maximum":160},"opacity":{"type":"number","minimum":0,"maximum":1},"color":{"type":"string","maxLength":64}},"required":["emojis"]}},"required":["type"]},"headerImageUrl":{"type":"string","format":"uri"},"avatar":{"type":"object","properties":{"color":{"type":"string","maxLength":64}},"additionalProperties":false},"titleColor":{"type":"string","maxLength":64},"subtitleColor":{"type":"string","maxLength":64},"button":{"type":"object","properties":{"style":{"type":"string","enum":["filled","outline","soft"]},"shape":{"type":"string","enum":["rounded","pill","square"]},"color":{"type":"string","maxLength":64},"textColor":{"type":"string","maxLength":64}}},"fonts":{"type":"object","properties":{"page":{"type":"string","enum":["manrope","commissioner","geologica","comfortaa","playpen-sans","arima","eb-garamond","literata","noto-serif-display","syne","roboto-slab","advent-pro"]},"title":{"type":"string","enum":["manrope","commissioner","geologica","comfortaa","playpen-sans","arima","eb-garamond","literata","noto-serif-display","syne","roboto-slab","advent-pro"]},"subtitle":{"type":"string","enum":["manrope","commissioner","geologica","comfortaa","playpen-sans","arima","eb-garamond","literata","noto-serif-display","syne","roboto-slab","advent-pro"]},"button":{"type":"string","enum":["manrope","commissioner","geologica","comfortaa","playpen-sans","arima","eb-garamond","literata","noto-serif-display","syne","roboto-slab","advent-pro"]}},"additionalProperties":false},"business":{"type":"object","properties":{"enabled":{"type":"boolean"},"kind":{"type":"string","enum":["restaurant","cafe","shop","salon","other"]},"name":{"type":"string","maxLength":100},"street":{"type":"string","maxLength":120},"town":{"type":"string","maxLength":60},"postcode":{"type":"string","maxLength":12,"pattern":"^[\\p{L}\\p{N}][\\p{L}\\p{N} -]*$"},"country":{"type":"string","enum":["GR","CY","AL","AU","AT","BE","BG","CA","HR","CZ","DK","EE","FI","FR","DE","HU","IE","IT","LV","LT","LU","MT","NL","MK","NO","PL","PT","RO","RS","SK","SI","ES","SE","CH","TR","GB","US"]},"phone":{"type":"string","maxLength":32},"website":{"type":"string","maxLength":2048},"hours":{"type":"object","properties":{"mo":{"maxItems":2,"type":"array","items":{"type":"object","properties":{"opens":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"},"closes":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"}},"required":["opens","closes"],"additionalProperties":false}},"tu":{"maxItems":2,"type":"array","items":{"type":"object","properties":{"opens":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"},"closes":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"}},"required":["opens","closes"],"additionalProperties":false}},"we":{"maxItems":2,"type":"array","items":{"type":"object","properties":{"opens":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"},"closes":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"}},"required":["opens","closes"],"additionalProperties":false}},"th":{"maxItems":2,"type":"array","items":{"type":"object","properties":{"opens":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"},"closes":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"}},"required":["opens","closes"],"additionalProperties":false}},"fr":{"maxItems":2,"type":"array","items":{"type":"object","properties":{"opens":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"},"closes":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"}},"required":["opens","closes"],"additionalProperties":false}},"sa":{"maxItems":2,"type":"array","items":{"type":"object","properties":{"opens":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"},"closes":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"}},"required":["opens","closes"],"additionalProperties":false}},"su":{"maxItems":2,"type":"array","items":{"type":"object","properties":{"opens":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"},"closes":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"}},"required":["opens","closes"],"additionalProperties":false}}},"additionalProperties":false}},"required":["enabled","kind","name"],"additionalProperties":false,"description":"Advanced → Show up on Google: the business details published as search-friendly page data. Kept as stored by a save of the look; changed only in the link editor."},"a11y":{"type":"object","properties":{"enabled":{"type":"boolean"},"lang":{"type":"string","enum":["el","en","de","fr","it","es","nl"]},"reading":{"type":"boolean"}},"required":["enabled"],"additionalProperties":false},"poll":{"type":"object","properties":{"enabled":{"type":"boolean"},"question":{"type":"string","maxLength":120},"answers":{"minItems":2,"maxItems":4,"type":"array","items":{"type":"string","maxLength":60}},"after":{"type":"string","enum":["results","thanks"]},"round":{"type":"integer","minimum":1,"maximum":1000000}},"required":["enabled","question","answers","after","round"],"additionalProperties":false,"description":"Advanced → Poll: one question with two to four answers shown on the page, and its round. Kept as stored by a save of the look; changed only in the link editor."},"languages":{"type":"object","properties":{"enabled":{"type":"boolean"},"second":{"type":"string","enum":["el","en"]},"title":{"type":"string","maxLength":1000},"subtitle":{"type":"string","maxLength":1000},"blocks":{"type":"object","propertyNames":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"additionalProperties":{"type":"string","maxLength":2000}}},"required":["enabled","second"],"additionalProperties":false},"iconRow":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"],"additionalProperties":false,"description":"Advanced → Icon row: whether buttons set to show as a small icon are drawn in a row of icons under the title. Kept as stored by a save of the look; changed only in the link editor."},"highlight":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"],"additionalProperties":false,"description":"Advanced → Highlight a button: whether the one button set to pulse, shine or wiggle moves when the page opens. Kept as stored by a save of the look; changed only in the link editor."},"notice":{"type":"object","properties":{"enabled":{"type":"boolean"},"text":{"type":"string","maxLength":120},"url":{"type":"string"},"color":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"from":{"type":"string"},"until":{"type":"string"},"timeZone":{"type":"string","maxLength":64}},"required":["enabled","text"],"additionalProperties":false,"description":"Advanced → Notice at the top: one short line across the top of the page, with an optional link, colour and first and last days (read in the project's time zone). Kept as stored by a save of the look; changed only in the link editor."},"share":{"type":"object","properties":{"enabled":{"type":"boolean"},"placement":{"type":"string","enum":["top","bottom"]},"actions":{"minItems":1,"maxItems":4,"type":"array","items":{"type":"string","enum":["system","copy","whatsapp","viber"]}},"text":{"type":"string","minLength":1,"maxLength":120}},"required":["enabled","placement","actions"],"additionalProperties":false,"description":"Advanced → Share button: a button on the page that shares the page's own address (the phone's share sheet, copy link, WhatsApp, Viber), at the top or the bottom, with optional words sent along. Kept as stored by a save of the look; changed only in the link editor."},"about":{"type":"object","properties":{"enabled":{"type":"boolean"},"since":{"type":"boolean","const":true},"text":{"type":"string","minLength":1,"maxLength":280},"website":{"type":"string"},"where":{"type":"string","minLength":1,"maxLength":120}},"required":["enabled"],"additionalProperties":false,"description":"Advanced → About this page (PRO): a small About link that opens a sheet with only the facts the owner ticked (a short text, since which month the page exists, an official website, where to find them). Kept as stored by a save of the look; changed only in the link editor."},"schedule":{"type":"object","properties":{"enabled":{"type":"boolean"},"from":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"until":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"fallback":{"type":"string","enum":["message","url"]},"url":{"type":"string"},"timeZone":{"type":"string","maxLength":64}},"required":["enabled","fallback"],"additionalProperties":false,"description":"Advanced → Schedule: when the link works (an optional start and end, UTC instants) and what a scan outside that window gets (a short message or another http/https address). Kept as stored by a save of the look; changed only in the link editor."},"buttonPictures":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"],"additionalProperties":false,"description":"Advanced → Button pictures: the switch (off by default) that lets buttons carry a picture. Kept as stored by a save of the look; changed only in the link editor."},"buttonSchedules":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"],"additionalProperties":false,"description":"Advanced → Button schedules: the switch (off by default) that lets a button show only between two dates. Kept as stored by a save of the look; changed only in the link editor."},"buttonGroups":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"],"additionalProperties":false,"description":"Advanced → Button groups: the switch (off by default) that lets a heading show the buttons under it as a section that opens on tap or as a grid (each heading's choice is its block's `groupLayout`). Kept as stored by a save of the look; changed only in the link editor."},"redirectRules":{"type":"object","properties":{"enabled":{"type":"boolean"},"rules":{"maxItems":10,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9-]{1,36}$"},"when":{"type":"object","properties":{"device":{"minItems":1,"maxItems":3,"type":"array","items":{"type":"string","enum":["phone","tablet","desktop"]}},"os":{"minItems":1,"maxItems":5,"type":"array","items":{"type":"string","enum":["ios","android","windows","macos","linux"]}},"country":{"minItems":1,"maxItems":30,"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"}},"language":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"string","pattern":"^[a-z]{2,3}$"}},"time":{"type":"object","properties":{"days":{"minItems":1,"maxItems":7,"type":"array","items":{"type":"integer","minimum":1,"maximum":7}},"from":{"type":"string","maxLength":5},"to":{"type":"string","maxLength":5}},"required":["days"],"additionalProperties":false}},"additionalProperties":false},"url":{"type":"string"}},"required":["id","when","url"],"additionalProperties":false}},"timeZone":{"type":"string","maxLength":64}},"required":["enabled","rules"],"additionalProperties":false,"description":"Advanced → Redirect rules (redirect links only): up to 10 rules, tried top to bottom, each sending a scan that matches all its conditions (device, system, country, language, days and hours in the project's time zone) to its own http/https address; no match goes to the link's destination. Kept as stored by a save of the look; changed only in the link editor."},"header":{"type":"object","properties":{"enabled":{"type":"boolean"},"layout":{"type":"string","enum":["classic","hero"]},"showAvatar":{"type":"boolean"},"logoUrl":{"type":"string"}},"required":["enabled","layout"],"additionalProperties":false,"description":"Advanced → Header style: the page's header as a full-width hero photo (the header banner, with the title on a dark fade) and/or the brand's logo in place of the typed title. Kept as stored by a save of the look; changed only in the link editor."},"footer":{"type":"object","properties":{"enabled":{"type":"boolean"},"mode":{"type":"string","enum":["hide","words"]},"text":{"type":"string","minLength":1,"maxLength":80},"url":{"type":"string"}},"required":["enabled","mode"],"additionalProperties":false,"description":"Advanced → Footer: hides the \"Powered by\" line at the bottom of the page, or replaces it with a short line of the owner's own words and an optional http/https link. Kept as stored by a save of the look; changed only in the link editor."},"buttonLocks":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"],"additionalProperties":false,"description":"Advanced → Lock a button: the switch (off by default) that lets a button ask \"I'm 18 or older\", show a sensitive-content warning, or ask for a code before it opens (each button's lock is its block's `lock`; a code is stored only as a salted hash and never returned). Kept as stored by a save of the look; changed only in the link editor."},"signupForm":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"],"additionalProperties":false,"description":"Advanced → Sign-up form (PRO): the switch (off by default) that lets the page carry Sign-up form blocks, which collect visitors' email addresses with their consent. Kept as stored by a save of the look; changed only in the link editor."}},"additionalProperties":false,"description":"The bio page's look: background, header image, avatar colour, text and button colours, fonts, the accessibility settings and the second-language words (Advanced → Languages). Image addresses must be `http(s)`."}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"background":{"type":"object","properties":{"type":{"type":"string","enum":["solid","gradient","image","pattern"]},"color":{"type":"string","maxLength":64},"gradient":{"type":"object","properties":{"from":{"type":"string","maxLength":64},"to":{"type":"string","maxLength":64},"angle":{"type":"number","minimum":0,"maximum":360}},"required":["from","to"],"additionalProperties":false},"imageUrl":{"type":"string","format":"uri"},"pattern":{"type":"object","properties":{"emojis":{"minItems":1,"maxItems":12,"type":"array","items":{"type":"string","minLength":1,"maxLength":8}},"size":{"type":"number","minimum":8,"maximum":96},"gap":{"type":"number","minimum":0,"maximum":160},"opacity":{"type":"number","minimum":0,"maximum":1},"color":{"type":"string","maxLength":64}},"required":["emojis"],"additionalProperties":false}},"required":["type"],"additionalProperties":false},"headerImageUrl":{"type":"string","format":"uri"},"avatar":{"type":"object","properties":{"color":{"type":"string","maxLength":64}},"additionalProperties":false},"titleColor":{"type":"string","maxLength":64},"subtitleColor":{"type":"string","maxLength":64},"button":{"type":"object","properties":{"style":{"type":"string","enum":["filled","outline","soft"]},"shape":{"type":"string","enum":["rounded","pill","square"]},"color":{"type":"string","maxLength":64},"textColor":{"type":"string","maxLength":64}},"additionalProperties":false},"fonts":{"type":"object","properties":{"page":{"type":"string","enum":["manrope","commissioner","geologica","comfortaa","playpen-sans","arima","eb-garamond","literata","noto-serif-display","syne","roboto-slab","advent-pro"]},"title":{"type":"string","enum":["manrope","commissioner","geologica","comfortaa","playpen-sans","arima","eb-garamond","literata","noto-serif-display","syne","roboto-slab","advent-pro"]},"subtitle":{"type":"string","enum":["manrope","commissioner","geologica","comfortaa","playpen-sans","arima","eb-garamond","literata","noto-serif-display","syne","roboto-slab","advent-pro"]},"button":{"type":"string","enum":["manrope","commissioner","geologica","comfortaa","playpen-sans","arima","eb-garamond","literata","noto-serif-display","syne","roboto-slab","advent-pro"]}},"additionalProperties":false},"business":{"type":"object","properties":{"enabled":{"type":"boolean"},"kind":{"type":"string","enum":["restaurant","cafe","shop","salon","other"]},"name":{"type":"string","maxLength":100},"street":{"type":"string","maxLength":120},"town":{"type":"string","maxLength":60},"postcode":{"type":"string","maxLength":12,"pattern":"^[\\p{L}\\p{N}][\\p{L}\\p{N} -]*$"},"country":{"type":"string","enum":["GR","CY","AL","AU","AT","BE","BG","CA","HR","CZ","DK","EE","FI","FR","DE","HU","IE","IT","LV","LT","LU","MT","NL","MK","NO","PL","PT","RO","RS","SK","SI","ES","SE","CH","TR","GB","US"]},"phone":{"type":"string","maxLength":32},"website":{"type":"string","maxLength":2048},"hours":{"type":"object","properties":{"mo":{"maxItems":2,"type":"array","items":{"type":"object","properties":{"opens":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"},"closes":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"}},"required":["opens","closes"],"additionalProperties":false}},"tu":{"maxItems":2,"type":"array","items":{"type":"object","properties":{"opens":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"},"closes":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"}},"required":["opens","closes"],"additionalProperties":false}},"we":{"maxItems":2,"type":"array","items":{"type":"object","properties":{"opens":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"},"closes":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"}},"required":["opens","closes"],"additionalProperties":false}},"th":{"maxItems":2,"type":"array","items":{"type":"object","properties":{"opens":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"},"closes":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"}},"required":["opens","closes"],"additionalProperties":false}},"fr":{"maxItems":2,"type":"array","items":{"type":"object","properties":{"opens":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"},"closes":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"}},"required":["opens","closes"],"additionalProperties":false}},"sa":{"maxItems":2,"type":"array","items":{"type":"object","properties":{"opens":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"},"closes":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"}},"required":["opens","closes"],"additionalProperties":false}},"su":{"maxItems":2,"type":"array","items":{"type":"object","properties":{"opens":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"},"closes":{"type":"string","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$"}},"required":["opens","closes"],"additionalProperties":false}}},"additionalProperties":false}},"required":["enabled","kind","name"],"additionalProperties":false,"description":"Advanced → Show up on Google: the business details published as search-friendly page data. Kept as stored by a save of the look; changed only in the link editor."},"a11y":{"type":"object","properties":{"enabled":{"type":"boolean"},"lang":{"type":"string","enum":["el","en","de","fr","it","es","nl"]},"reading":{"type":"boolean"}},"required":["enabled"],"additionalProperties":false},"poll":{"type":"object","properties":{"enabled":{"type":"boolean"},"question":{"type":"string","maxLength":120},"answers":{"minItems":2,"maxItems":4,"type":"array","items":{"type":"string","maxLength":60}},"after":{"type":"string","enum":["results","thanks"]},"round":{"type":"integer","minimum":1,"maximum":1000000}},"required":["enabled","question","answers","after","round"],"additionalProperties":false,"description":"Advanced → Poll: one question with two to four answers shown on the page, and its round. Kept as stored by a save of the look; changed only in the link editor."},"languages":{"type":"object","properties":{"enabled":{"type":"boolean"},"second":{"type":"string","enum":["el","en"]},"title":{"type":"string","maxLength":1000},"subtitle":{"type":"string","maxLength":1000},"blocks":{"type":"object","propertyNames":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"additionalProperties":{"type":"string","maxLength":2000}}},"required":["enabled","second"],"additionalProperties":false},"iconRow":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"],"additionalProperties":false,"description":"Advanced → Icon row: whether buttons set to show as a small icon are drawn in a row of icons under the title. Kept as stored by a save of the look; changed only in the link editor."},"highlight":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"],"additionalProperties":false,"description":"Advanced → Highlight a button: whether the one button set to pulse, shine or wiggle moves when the page opens. Kept as stored by a save of the look; changed only in the link editor."},"notice":{"type":"object","properties":{"enabled":{"type":"boolean"},"text":{"type":"string","maxLength":120},"url":{"type":"string"},"color":{"type":"string","pattern":"^#(?:[0-9a-f]{3}|[0-9a-f]{6})$"},"from":{"type":"string"},"until":{"type":"string"},"timeZone":{"type":"string","maxLength":64}},"required":["enabled","text"],"additionalProperties":false,"description":"Advanced → Notice at the top: one short line across the top of the page, with an optional link, colour and first and last days (read in the project's time zone). Kept as stored by a save of the look; changed only in the link editor."},"share":{"type":"object","properties":{"enabled":{"type":"boolean"},"placement":{"type":"string","enum":["top","bottom"]},"actions":{"minItems":1,"maxItems":4,"type":"array","items":{"type":"string","enum":["system","copy","whatsapp","viber"]}},"text":{"type":"string","minLength":1,"maxLength":120}},"required":["enabled","placement","actions"],"additionalProperties":false,"description":"Advanced → Share button: a button on the page that shares the page's own address (the phone's share sheet, copy link, WhatsApp, Viber), at the top or the bottom, with optional words sent along. Kept as stored by a save of the look; changed only in the link editor."},"about":{"type":"object","properties":{"enabled":{"type":"boolean"},"since":{"type":"boolean","const":true},"text":{"type":"string","minLength":1,"maxLength":280},"website":{"type":"string"},"where":{"type":"string","minLength":1,"maxLength":120}},"required":["enabled"],"additionalProperties":false,"description":"Advanced → About this page (PRO): a small About link that opens a sheet with only the facts the owner ticked (a short text, since which month the page exists, an official website, where to find them). Kept as stored by a save of the look; changed only in the link editor."},"schedule":{"type":"object","properties":{"enabled":{"type":"boolean"},"from":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"until":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"fallback":{"type":"string","enum":["message","url"]},"url":{"type":"string"},"timeZone":{"type":"string","maxLength":64}},"required":["enabled","fallback"],"additionalProperties":false,"description":"Advanced → Schedule: when the link works (an optional start and end, UTC instants) and what a scan outside that window gets (a short message or another http/https address). Kept as stored by a save of the look; changed only in the link editor."},"buttonPictures":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"],"additionalProperties":false,"description":"Advanced → Button pictures: the switch (off by default) that lets buttons carry a picture. Kept as stored by a save of the look; changed only in the link editor."},"buttonSchedules":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"],"additionalProperties":false,"description":"Advanced → Button schedules: the switch (off by default) that lets a button show only between two dates. Kept as stored by a save of the look; changed only in the link editor."},"buttonGroups":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"],"additionalProperties":false,"description":"Advanced → Button groups: the switch (off by default) that lets a heading show the buttons under it as a section that opens on tap or as a grid (each heading's choice is its block's `groupLayout`). Kept as stored by a save of the look; changed only in the link editor."},"redirectRules":{"type":"object","properties":{"enabled":{"type":"boolean"},"rules":{"maxItems":10,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9-]{1,36}$"},"when":{"type":"object","properties":{"device":{"minItems":1,"maxItems":3,"type":"array","items":{"type":"string","enum":["phone","tablet","desktop"]}},"os":{"minItems":1,"maxItems":5,"type":"array","items":{"type":"string","enum":["ios","android","windows","macos","linux"]}},"country":{"minItems":1,"maxItems":30,"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"}},"language":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"string","pattern":"^[a-z]{2,3}$"}},"time":{"type":"object","properties":{"days":{"minItems":1,"maxItems":7,"type":"array","items":{"type":"integer","minimum":1,"maximum":7}},"from":{"type":"string","maxLength":5},"to":{"type":"string","maxLength":5}},"required":["days"],"additionalProperties":false}},"additionalProperties":false},"url":{"type":"string"}},"required":["id","when","url"],"additionalProperties":false}},"timeZone":{"type":"string","maxLength":64}},"required":["enabled","rules"],"additionalProperties":false,"description":"Advanced → Redirect rules (redirect links only): up to 10 rules, tried top to bottom, each sending a scan that matches all its conditions (device, system, country, language, days and hours in the project's time zone) to its own http/https address; no match goes to the link's destination. Kept as stored by a save of the look; changed only in the link editor."},"header":{"type":"object","properties":{"enabled":{"type":"boolean"},"layout":{"type":"string","enum":["classic","hero"]},"showAvatar":{"type":"boolean"},"logoUrl":{"type":"string"}},"required":["enabled","layout"],"additionalProperties":false,"description":"Advanced → Header style: the page's header as a full-width hero photo (the header banner, with the title on a dark fade) and/or the brand's logo in place of the typed title. Kept as stored by a save of the look; changed only in the link editor."},"footer":{"type":"object","properties":{"enabled":{"type":"boolean"},"mode":{"type":"string","enum":["hide","words"]},"text":{"type":"string","minLength":1,"maxLength":80},"url":{"type":"string"}},"required":["enabled","mode"],"additionalProperties":false,"description":"Advanced → Footer: hides the \"Powered by\" line at the bottom of the page, or replaces it with a short line of the owner's own words and an optional http/https link. Kept as stored by a save of the look; changed only in the link editor."},"buttonLocks":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"],"additionalProperties":false,"description":"Advanced → Lock a button: the switch (off by default) that lets a button ask \"I'm 18 or older\", show a sensitive-content warning, or ask for a code before it opens (each button's lock is its block's `lock`; a code is stored only as a salted hash and never returned). Kept as stored by a save of the look; changed only in the link editor."},"signupForm":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"],"additionalProperties":false,"description":"Advanced → Sign-up form (PRO): the switch (off by default) that lets the page carry Sign-up form blocks, which collect visitors' email addresses with their consent. Kept as stored by a save of the look; changed only in the link editor."}},"additionalProperties":false,"description":"The bio page's look: background, header image, avatar colour, text and button colours, fonts, the accessibility settings and the second-language words (Advanced → Languages). Image addresses must be `http(s)`."}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/PayloadTooLarge"},"415":{"$ref":"#/components/responses/UnsupportedMediaType"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}},"security":[{"bearerAuth":[]}]}},"/me":{"get":{"operationId":"getMe","tags":["me"],"summary":"The key and its project","description":"Confirms the key works and names the project it acts in. Call it first.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"project":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"},"slug":{"type":"string"}},"required":["id","name","slug"],"additionalProperties":false},"key":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"},"prefix":{"type":"string","description":"The first 12 characters of the key, as the Settings list shows it."},"scopes":{"type":"array","items":{"type":"string","enum":["read","write"]}},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","description":"ISO 8601, UTC, e.g. `2026-10-12T09:30:00.000Z`."},"expiresAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","description":"ISO 8601, UTC, e.g. `2026-10-12T09:30:00.000Z`."},{"type":"null"}]}},"required":["id","name","prefix","scopes","createdAt","expiresAt"],"additionalProperties":false},"version":{"type":"string","const":"v1"}},"required":["project","key","version"],"additionalProperties":false}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"}},"security":[{"bearerAuth":[]}]}},"/openapi.json":{"get":{"operationId":"getOpenApiDocument","tags":["openapi"],"summary":"The OpenAPI 3.1 description of this API","description":"Generated from the same route definitions the server enforces, so it is always current. No key needed.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"openapi":{"type":"string","const":"3.1.0"},"info":{"type":"object","properties":{"title":{"type":"string"},"version":{"type":"string"}},"required":["title","version"],"additionalProperties":{}},"paths":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["openapi","info","paths"],"additionalProperties":{},"description":"An OpenAPI 3.1 document."}}}},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}}},"servers":[{"url":"/api/v1"}],"tags":[{"name":"me","description":"The key and its project."},{"name":"links","description":"QR codes: create, read, edit, archive and restore."},{"name":"qr","description":"How a QR code looks and what it encodes."},{"name":"theme","description":"A bio page's look."},{"name":"tags","description":"The tags a QR code is filed under."},{"name":"blocks","description":"A bio page's buttons and content."},{"name":"placements","description":"Printed runs of a QR code."},{"name":"analytics","description":"Scans and taps."},{"name":"openapi","description":"This document."}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"A project API key from Settings → API keys, sent as `Authorization: Bearer qrc_…`."}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_json","unsupported_media_type","payload_too_large","validation_failed","unauthorized","key_revoked","key_expired","insufficient_scope","feature_unavailable","project_disabled","not_found","conflict","link_archived","rate_limited","internal_error"]},"message":{"type":"string","description":"Plain English, safe to show."},"details":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string","description":"The field, dotted for nesting (`theme.colors.bg`)."},"code":{"type":"string","description":"The rule it broke, e.g. `too_big`, `invalid_format`."},"message":{"type":"string"}},"required":["path","code","message"],"additionalProperties":false}}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false,"description":"The shape of every error answer."}},"responses":{"BadRequest":{"description":"The body is not JSON (`invalid_json`) or a field is missing or not valid (`validation_failed`, with `details`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unauthorized":{"description":"No usable key: missing or malformed (`unauthorized`), revoked (`key_revoked`) or expired (`key_expired`). Carries `WWW-Authenticate: Bearer`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Forbidden":{"description":"The key cannot do this: a read-only key on a write (`insufficient_scope`), API access is not available for the project (`feature_unavailable`), or the project is disabled (`project_disabled`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"Nothing there for this key (`not_found`): an id outside the key's project looks exactly like one that does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Conflict":{"description":"The change clashes with the current state (`conflict`), or the QR code is archived and must be restored first (`link_archived`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"PayloadTooLarge":{"description":"The body is over 64 KB (`payload_too_large`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"UnsupportedMediaType":{"description":"The body is not `application/json` (`unsupported_media_type`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"TooManyRequests":{"description":"Over the key's limit (`rate_limited`). Carries `Retry-After` and `X-RateLimit-*`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"InternalError":{"description":"Something failed on the server (`internal_error`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}