Printago API
PATCH /v1/sequences/{id}

Update a sequence

Rewinding `nextValue` below an already-issued number requires `confirmRewind: true` — it deliberately reissues serials that were already printed. Fast-forwarding only skips numbers and needs no confirmation.

Requires: sequence.edit

Path Parameters

id required
string
Sequence ID

Request Body

Fields to update

SequenceUpdate
confirmRewindoptional
boolean
Required when `nextValue` moves backwards past a value that has already been issued: rewinding is the one deliberate way to break the never-reissue guarantee, so it must be explicitly acknowledged.
nameoptional
string
nextValueoptional
integer
min: 1
numberStyleoptional
any
paddingoptional
integer
min: 1max: 12
prefixoptional
string
suffixoptional
string

Example Request

application/json 
{
  "name": "string",
  "nextValue": 1,
  "prefix": "string",
  "suffix": "string",
  "padding": 1,
  "confirmRewind": true
}

Response Schema

Sequence
createdAtrequired
string
format: date-time
idrequired
string
pattern: ^[a-z0-9]{24}$
namerequired
string
nextValuerequired
number
numberStylerequired
any
paddingrequired
number
prefixrequired
string
storeIdrequired
string
pattern: ^[a-z0-9]{24}$
suffixrequired
string
updatedAtrequired
string
format: date-time

Example Response

200 OK — application/json 
{
  "name": "string",
  "nextValue": 1,
  "prefix": "string",
  "suffix": "string",
  "padding": 1,
  "id": "string",
  "storeId": "string",
  "createdAt": "2026-09-13T00:32:49.723Z",
  "updatedAt": "2026-09-13T00:32:49.723Z"
}