Create a new operating-instructions version
Author a new operating-instructions version. The new version number is computed atomically as MAX(version)+1 for the storefront. Does not auto-activate — call the activate endpoint to swap the storefront’s active pointer.
Authorizations
API key or access token
Body
Request body for creating a new operating-instructions version and optionally activating it atomically.
Markdown body the Merchandising Agent will use for product packaging, naming, selection, and explanation. Actual prices/floors/currencies belong in Selling Terms; brand/operator discounts belong in Buyer Discounts and Buyer Instructions; storefront markets belong in Business Profile; advertiser/category/creative eligibility belongs in Acceptance Policy.
1 - 50000Operator note describing why this version was created (e.g. "tighten brand-safety rules"). Not surfaced to buyers; visible in the version history UI.
2000When true, create and activate this immutable version atomically. Defaults to false.
Response
Create a new operating-instructions version
A single operating-instructions version for a storefront. Versions are immutable; updates produce a new row.
Surrogate id of the version row (BIGINT serialized as string).
"42"
Storefront the version belongs to (BIGINT serialized as string).
"1234"
Per-storefront version number. Monotone, never reused. The first version a storefront authors is 1.
1 <= x <= 90071992547409913
Markdown body consumed by the Merchandising Agent.
Operator note about why this version was authored.
Whether this version is the Storefront's active operating instructions (the version the Merchandising Agent will use on the next composition).
Creation timestamp (ISO 8601). Rows are immutable so there is no updatedAt.
^(?:(?:\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))$User id of the operator who authored the version (BIGINT serialized as string). Null when authored by a system or service-token caller.
Canonical-ownership conflicts detected in this immutable version. Empty for versions that keep pricing, discounts, markets, and acceptance facts in their owning storefront surfaces.