Update a saved barcode
Changes a saved barcode's title, format, value, options or folder. Send only the fields to change.
options replaces the saved options: fields you leave out go back to the format's defaults. A new format without options starts from the new format's defaults. The value is checked like a new one.
Scope: codes:write, for API keys and OAuth tokens alike.
AuthorizationBearer <qrdx_ followed by 40 letters and digits>An API key, sent as Authorization: Bearer qrdx_…. Create one in Settings → API keys & apps: it is shown once. A key acts on the workspace it was created in as its creator, with their current role there, and only within its scopes, the same scopes as OAuth (each operation names the one it needs). API keys.
id*stringThe barcode's id
1 <= length <= 64application/json- body
title?|A name to find it by, up to 100 characters (default: none; lists show the value)
format?stringThe symbology, as GET /barcode takes it: ean13, ean8, upca, upce, code128, code39, itf14, gs1-128, datamatrix, pdf417 or aztec
"ean13""ean8""upca""upce""code128""code39""itf14""gs1-128""datamatrix""pdf417""aztec"value?stringThe number or text to encode, checked against the format's rules. Retail numbers can leave the check digit off and it's added.
1 <= length <= 1000options?How it's drawn: replaces the saved options (fields left out go back to the format's defaults)
folderId?|A folder of the workspace by id (the codes' folders); null for none
The updated barcode
application/json- response
data*A saved barcode
curl -X PATCH 'https://api.qrdx.dev/v1/barcodes/cm5barcode0spring0box0001' \ -H 'Content-Type: application/json' \ -d '{ "value": "400638133393"}'{ "data": { "id": "cm5barcode0spring0box0001", "title": "Spring box", "format": "ean13", "formatLabel": "EAN-13", "value": "4006381333931", "options": { "foreground": "#000000", "background": "#ffffff", "showText": true, "barHeightMm": 23, "quietZone": 11, "scale": 4, "rotation": 0 }, "folderId": null, "imageUrl": "https://qrdx.dev/api/v1/barcode?format=ean13&data=5901234123457", "createdAt": "2026-01-05T09:30:00.000Z", "updatedAt": "2026-01-05T09:30:00.000Z", "deletedAt": null, "organizationId": null }}Last updated on