Update a lot template
Update template fields. A format-affecting change (format_string, character_set, check_digit_algorithm, target_field) on an in-use template bumps the version and migrates the counter forward, preserving the current sequence value. An unused template updates in place.
Authorizations
Path Parameters
Template id (UUID or 22-char shortuuid).
Body
Request body for PATCH /lots/templates/{id}/. All fields optional; a
format-affecting change to an in-use template bumps the version and migrates
the counter forward.
New name.
128New token format (revalidated).
256New notes.
2000New alphabet identifier.
64New check-digit algorithm.
none, mod10, iso7064_11_2 New reset condition.
never, daily, weekly, monthly, on_product_change, on_count_reached, manual New on_count_reached threshold.
x >= 1New scope partitioning.
global, per_product, per_product_per_date_bucket, tag New post-reset starting value.
x >= 1New soft-retry budget.
0 <= x <= 50Response
OK
A saved generation recipe (latest version).
Template id (22-char shortuuid). Use in /lots/templates/{id}/ paths.
Human-readable template name.
Which GS1 field the identifiers populate.
lot, serial Token format, e.g. LOT-{YYYY}{JJJ}-{####} renders as LOT-2026123-0001.
Alphabet identifier or literal characters. Defaults to GS1 AI 82.
Optional check character appended after token expansion.
none, mod10, iso7064_11_2 When the counter resets to its starting value.
never, daily, weekly, monthly, on_product_change, on_count_reached, manual How the counter is partitioned (the scope_key shape).
global, per_product, per_product_per_date_bucket, tag Counter value used after a reset (first sequence emitted).
Soft-retry budget per identifier for random-source tokens before a hard collision.
Current template version. Bumps on a format-affecting edit while in use.
Archived templates cannot generate until unarchived.
Creation timestamp (ISO-8601).
Last-modified timestamp (ISO-8601).
Optional free-text notes.
Counter value that triggers a reset when reset_condition=on_count_reached.
Reserved for row-per-version chains; null in the current in-place versioning scheme.