> For the complete documentation index, see [llms.txt](https://docs.intelligems.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.intelligems.io/developer-resources/external-api/manage-checkout-blocks.md).

# Manage Checkout Blocks

Checkout blocks are the content a `checkoutBlock` or `postPurchase` experience tests. Each block belongs to one variation. The following block types are supported:

* `trustBadge` — Trust badges, guarantees, or brand logos
* `upsell` — Product recommendations in checkout
* `shippingProgressBar` — Progress toward free shipping
* `timer` — A countdown timer
* `faqs` — Collapsible questions and answers
* `postPurchaseUpsell` — A one-click offer shown after checkout

`blockType` picks which `variables` (content settings), `styles`, and `template` values a request accepts. Unknown fields are rejected with a `400` that names the field.

**Create vs. replace.** `POST` keeps the template's value for every field you leave out, at any depth, so a minimal body creates a complete block. `PUT` replaces the block's content: `name`, `variables`, and `styles` are required, and every field you leave out, at any depth, resets to the template's value instead of keeping the saved one. The exception is `postPurchaseUpsell`: its `PUT` merges the fields you send onto the saved block. A post-purchase upsell may also adjust related settings on its own to stay valid, and lists what it changed in the response's `adjustments`.

**Post-purchase readiness.** Adding a `postPurchaseUpsell` block checks that the store is ready for post-purchase upsells (plan, Shopify permissions, and settings), and returns a `400` listing what to fix if it isn't. API keys get no exemption from this check. Replacing an existing post-purchase upsell with `PUT` doesn't re-run it.

**Discounts.** Discounts can't be set with an API key. Set an offer's discount in Intelligems, or through the Intelligems MCP while signed in. A request that sends one gets a `400`: that's an upsell's `variables.discount`, a product rule's `discount`, or a post-purchase upsell's `discountType` or `discountValue`. A `PUT` keeps the discount saved on the block, along with the settings that decide who gets it: the block's product rules and display conditions, `maxProductLimit` and `excludeItemsInCart`, and a post-purchase upsell's `maxQuantityType` and `maxQuantity`. Changing any of those on a discounted block returns a `400`. You can still rename a discounted block, change its copy and styles, and change a post-purchase upsell's `compareAtPriceDisplay`, which only changes the struck-through price shown. A block without a discount takes any change.

**Display conditions and upsell rules.** `displayConditions` (when a block shows) and `upsellProductRules` (which products an `upsell` or `postPurchaseUpsell` block recommends) are written as a flat list of conditions joined by `match: "all"` or `"any"`. On `PUT`, omit a field to keep its current value, send `null` to remove it, or send a value to replace it. `postPurchaseUpsell` blocks don't use display conditions, and only `upsell` and `postPurchaseUpsell` blocks take product rules.

**Reading blocks back.** `GET` returns the blocks as they are stored. Stored display conditions and product rules are in the compiled form the storefront evaluates, not the condition-list form you send, so don't send them back on `PUT`.

**Live tests.** You can add, change, and delete blocks on a running experience. Changes take effect for shoppers immediately.

Your organization's plan must include checkout block tests; otherwise every checkout-block endpoint returns a `403`.

## List checkout blocks

> Lists an experience's checkout blocks, grouped by variation.\
> \
> The response has one entry per variation, each with its \`variationId\`, \`name\`, \`isControl\`, and \`blocks\`:\
> \
> \`\`\`json\
> {\
> &#x20; "variations": \[\
> &#x20;   {\
> &#x20;     "variationId": "YOUR\_VARIATION\_ID",\
> &#x20;     "name": "Control",\
> &#x20;     "isControl": true,\
> &#x20;     "blocks": \[]\
> &#x20;   }\
> &#x20; ]\
> }\
> \`\`\`\
> \
> \### Query Parameters\
> \
> All query parameters are optional.\
> \
> \- \`variationId\` (UUID) — Only return this variation's blocks.\
> \- \`blockType\` (string) — Only return blocks of this type.\
> \
> \### Important Notes\
> \
> \- Each block is returned as stored, including its \`id\`, which the \`PUT\` and \`DELETE\` endpoints take.\
> \- \`displayConditions\` and \`upsellProductRules\` come back in the compiled form the storefront evaluates, not the condition-list form you send on \`POST\` and \`PUT\`.\
> \
> \*\*Rate Limit:\*\* 50 requests per 30s window, refilling 25 tokens every 30s.

````json
{"openapi":"3.1.0","info":{"title":"Intelligems External API v25-10-beta","version":"v25-10-beta"},"tags":[{"name":"Manage Checkout Blocks","description":"Checkout blocks are the content a `checkoutBlock` or `postPurchase` experience tests. Each block belongs to one variation. The following block types are supported:\n\n- `trustBadge` — Trust badges, guarantees, or brand logos\n- `upsell` — Product recommendations in checkout\n- `shippingProgressBar` — Progress toward free shipping\n- `timer` — A countdown timer\n- `faqs` — Collapsible questions and answers\n- `postPurchaseUpsell` — A one-click offer shown after checkout\n\n`blockType` picks which `variables` (content settings), `styles`, and `template` values a request accepts. Unknown fields are rejected with a `400` that names the field.\n\n**Create vs. replace.** `POST` keeps the template's value for every field you leave out, at any depth, so a minimal body creates a complete block. `PUT` replaces the block's content: `name`, `variables`, and `styles` are required, and every field you leave out, at any depth, resets to the template's value instead of keeping the saved one. The exception is `postPurchaseUpsell`: its `PUT` merges the fields you send onto the saved block. A post-purchase upsell may also adjust related settings on its own to stay valid, and lists what it changed in the response's `adjustments`.\n\n**Post-purchase readiness.** Adding a `postPurchaseUpsell` block checks that the store is ready for post-purchase upsells (plan, Shopify permissions, and settings), and returns a `400` listing what to fix if it isn't. API keys get no exemption from this check. Replacing an existing post-purchase upsell with `PUT` doesn't re-run it.\n\n**Discounts.** Discounts can't be set with an API key. Set an offer's discount in Intelligems, or through the Intelligems MCP while signed in. A request that sends one gets a `400`: that's an upsell's `variables.discount`, a product rule's `discount`, or a post-purchase upsell's `discountType` or `discountValue`. A `PUT` keeps the discount saved on the block, along with the settings that decide who gets it: the block's product rules and display conditions, `maxProductLimit` and `excludeItemsInCart`, and a post-purchase upsell's `maxQuantityType` and `maxQuantity`. Changing any of those on a discounted block returns a `400`. You can still rename a discounted block, change its copy and styles, and change a post-purchase upsell's `compareAtPriceDisplay`, which only changes the struck-through price shown. A block without a discount takes any change.\n\n**Display conditions and upsell rules.** `displayConditions` (when a block shows) and `upsellProductRules` (which products an `upsell` or `postPurchaseUpsell` block recommends) are written as a flat list of conditions joined by `match: \"all\"` or `\"any\"`. On `PUT`, omit a field to keep its current value, send `null` to remove it, or send a value to replace it. `postPurchaseUpsell` blocks don't use display conditions, and only `upsell` and `postPurchaseUpsell` blocks take product rules.\n\n**Reading blocks back.** `GET` returns the blocks as they are stored. Stored display conditions and product rules are in the compiled form the storefront evaluates, not the condition-list form you send, so don't send them back on `PUT`.\n\n**Live tests.** You can add, change, and delete blocks on a running experience. Changes take effect for shoppers immediately.\n\nYour organization's plan must include checkout block tests; otherwise every checkout-block endpoint returns a `403`."}],"servers":[{"url":"https://api.intelligems.io","description":"Production"}],"security":[{"intelligems_access_token":[]}],"components":{"securitySchemes":{"intelligems_access_token":{"type":"apiKey","in":"header","name":"intelligems-access-token","description":"Intelligems external API access token."}},"schemas":{"__schema0":{"type":"object","properties":{"discountType":{"default":"none","type":"string","enum":["none","percentage","fixed"]},"discountValue":{"type":["number","null"]},"compareAtPriceDisplay":{"default":"none","type":"string","enum":["none","compareAtPrice","regularPrice"]},"expression":{"type":"array","items":{"type":"object","properties":{"query":{"type":"object","properties":{"key":{"type":"string","enum":["shopifyRecommendations","productId","collection","tag"]},"type":{"type":"string","enum":["shopifyRecommendations","productId","collection","tag"]},"filter":{"type":"string","enum":["includes","doesNotInclude"]},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"array","items":{"type":"object","properties":{"order":{"type":"number"},"productId":{"type":"string"},"productTitle":{"type":"string"},"handle":{"type":["string","null"]},"productImage":{"type":["string","null"]},"description":{"type":["string","null"]},"options":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"values":{"type":"array","items":{"type":"string"}}},"required":["name","values"],"additionalProperties":false}},"variants":{"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string"},"variantTitle":{"type":"string"},"variantImage":{"type":["string","null"]},"price":{"type":"number"},"compareAtPrice":{"type":["number","null"]},"currencyCode":{"type":"string"},"availableForSale":{"type":"boolean"},"sig":{"type":["string","null"]},"inclusionType":{"type":"string","enum":["include","exclude"]},"variantOptions":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"}},"required":["name","value"],"additionalProperties":false}}},"required":["variantId","variantTitle","price","inclusionType"],"additionalProperties":false}},"defaultVariantId":{"type":["string","null"]}},"required":["order","productId","productTitle","variants"],"additionalProperties":false}}]}},"required":["key","type"],"additionalProperties":false},"operator":{"type":"string","enum":["and","or","start_paren","end_paren"]}},"additionalProperties":false}},"onAccept":{"anyOf":[{"$ref":"#/components/schemas/__schema0"},{"type":"null"}]},"onDecline":{"anyOf":[{"$ref":"#/components/schemas/__schema0"},{"type":"null"}]}},"required":["discountType","compareAtPriceDisplay","expression"],"additionalProperties":false}}},"paths":{"/v25-10-beta/experiences/{experienceId}/checkout-blocks":{"get":{"operationId":"getCheckoutBlocks","summary":"List checkout blocks","tags":["Manage Checkout Blocks"],"description":"Lists an experience's checkout blocks, grouped by variation.\n\nThe response has one entry per variation, each with its `variationId`, `name`, `isControl`, and `blocks`:\n\n```json\n{\n  \"variations\": [\n    {\n      \"variationId\": \"YOUR_VARIATION_ID\",\n      \"name\": \"Control\",\n      \"isControl\": true,\n      \"blocks\": []\n    }\n  ]\n}\n```\n\n### Query Parameters\n\nAll query parameters are optional.\n\n- `variationId` (UUID) — Only return this variation's blocks.\n- `blockType` (string) — Only return blocks of this type.\n\n### Important Notes\n\n- Each block is returned as stored, including its `id`, which the `PUT` and `DELETE` endpoints take.\n- `displayConditions` and `upsellProductRules` come back in the compiled form the storefront evaluates, not the condition-list form you send on `POST` and `PUT`.\n\n**Rate Limit:** 50 requests per 30s window, refilling 25 tokens every 30s.","parameters":[{"in":"path","name":"experienceId","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)$","description":"The experience the checkout block belongs to."},"required":true,"description":"The experience the checkout block belongs to."},{"in":"query","name":"variationId","schema":{"description":"Only return blocks on this variation.","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":"Only return blocks on this variation."},{"in":"query","name":"blockType","schema":{"description":"Only return blocks of this type.","type":"string","enum":["trustBadge","upsell","shippingProgressBar","timer","faqs","postPurchaseUpsell"]},"description":"Only return blocks of this type."}],"responses":{"200":{"description":"OK","headers":{"access-control-allow-origin":{"schema":{"type":"string"},"description":"CORS allow-origin header."},"access-control-allow-credentials":{"schema":{"type":"string"},"description":"CORS allow-credentials header."},"content-type":{"schema":{"type":"string"},"description":"Response content type."},"Timing-Allow-Origin":{"schema":{"type":"string"},"description":"Allowed origin for Timing headers."},"X-RateLimit-Limit":{"schema":{"type":"string"},"description":"Maximum requests allowed in the current window."},"X-RateLimit-Remaining":{"schema":{"type":"string"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"string"},"description":"Unix timestamp (ms) when the rate limit resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"variations":{"type":"array","items":{"type":"object","properties":{"variationId":{"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"},"isControl":{"type":"boolean"},"blocks":{"type":"array","items":{"oneOf":[{"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)$","description":"Server-generated. Read-only."},"variationId":{"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":"References the parent variation."},"locationId":{"type":"string","description":"Shopify checkout extensibility target location where the block renders."},"blockType":{"type":"string","const":"trustBadge"},"blockTemplate":{"description":"The template preset this block was created from, within its block type. Null on blocks saved before templates were persisted, which callers must treat as unknown rather than assuming a default.","anyOf":[{"type":"string","enum":["badgeList","badgeTiles","callOut","grid","header","images","brandLogo","textOnly"]},{"type":"null"}]},"name":{"type":"string","description":"Display name for identifying this block in the dashboard."},"displayConditions":{"description":"Optional cart-based conditions; the block renders only when the expression evaluates true against the current cart.","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)$"},"expression":{"type":"array","items":{"type":"object","properties":{"query":{"type":"object","properties":{"key":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"type":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"filter":{"type":"string","enum":["includes","doesNotInclude","greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string"},"inclusionType":{"type":"string","enum":["include","exclude"]}},"required":["variantId","inclusionType"],"additionalProperties":false}}}]}},"required":["key","type","filter"],"additionalProperties":false},"operator":{"type":"string","enum":["and","or","start_paren","end_paren"]}},"additionalProperties":false}}},"required":["id","expression"],"additionalProperties":false},"variables":{"type":"object","properties":{"headerText":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]},"items":{"type":"array","items":{"type":"object","properties":{"order":{"type":"number"},"title":{"anyOf":[{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]},{"type":"null"}]},"subtitle":{"anyOf":[{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]},{"type":"null"}]},"type":{"type":"string"},"icon":{"type":["string","null"]},"iconColor":{"type":["string","null"]},"iconSize":{"type":["string","null"]},"imageSize":{"anyOf":[{"type":"number","minimum":1,"maximum":500},{"type":"null"}]},"imageSizeUnit":{"type":"string","enum":["pixels","percentage"]},"imageAspectRatio":{"type":["string","null"]},"image":{"type":["string","null"]},"mediaSpacing":{"type":"string"}},"required":["order","type","imageSize","imageSizeUnit","mediaSpacing"],"additionalProperties":false}}},"required":["headerText","items"],"additionalProperties":false,"description":"Configurable content for the trust badge (e.g., badge images, guarantee text)."},"styles":{"type":"object","properties":{"typography":{"type":"object","properties":{"header":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"itemTitle":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"itemSubtitle":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false}},"required":["header","itemTitle","itemSubtitle"],"additionalProperties":false},"backgroundColors":{"type":"object","properties":{"header":{"type":"string"},"item":{"type":"string"},"block":{"type":"string"}},"required":["header","item","block"],"additionalProperties":false},"colors":{"type":"object","properties":{"headerText":{"type":"string"},"itemTitleText":{"type":"string"},"itemSubtitleText":{"type":"string"}},"required":["headerText","itemTitleText","itemSubtitleText"],"additionalProperties":false},"layout":{"type":"object","properties":{"headerTextAlign":{"type":"string"},"bodyAlign":{"type":"string"},"itemTextAlign":{"type":"string"},"itemPositionAlign":{"type":"string"},"rowCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"columnCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["headerTextAlign","bodyAlign","itemTextAlign","itemPositionAlign","rowCount","columnCount"],"additionalProperties":false},"appearance":{"type":"object","properties":{"headerBorderThickness":{"type":"string"},"headerBorderStyle":{"default":"none","type":"string"},"headerCornerRadius":{"type":"string"},"headerPadding":{"type":"string"},"bodySpacing":{"type":"string"},"headingToBodySpacing":{"type":"string"},"blockBorderThickness":{"type":"string"},"blockBorderStyle":{"default":"none","type":"string"},"blockPadding":{"type":"string"},"blockCornerRadius":{"type":"string"},"itemBorderThickness":{"type":"string"},"itemBorderStyle":{"default":"none","type":"string"},"itemCornerRadius":{"type":"string"},"itemTextSpacing":{"type":"string"}},"required":["headerBorderThickness","headerBorderStyle","headerCornerRadius","headerPadding","bodySpacing","headingToBodySpacing","blockBorderThickness","blockBorderStyle","blockPadding","blockCornerRadius","itemBorderThickness","itemBorderStyle","itemCornerRadius","itemTextSpacing"],"additionalProperties":false}},"required":["typography","backgroundColors","colors","layout","appearance"],"additionalProperties":false,"description":"CSS styling overrides for the trust badge appearance."}},"required":["id","variationId","locationId","blockType","name","variables","styles"],"additionalProperties":false},{"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)$","description":"Server-generated. Read-only."},"variationId":{"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":"References the parent variation."},"locationId":{"type":"string","description":"Shopify checkout extensibility target location where the block renders."},"blockType":{"type":"string","const":"upsell"},"blockTemplate":{"description":"The template preset this block was created from, within its block type. Null on blocks saved before templates were persisted, which callers must treat as unknown rather than assuming a default.","anyOf":[{"type":"string","enum":["productTiles","productList","singleProduct","singleProductCheckbox"]},{"type":"null"}]},"name":{"type":"string","description":"Display name for identifying this block in the dashboard."},"displayConditions":{"description":"Optional cart-based conditions; the block renders only when the expression evaluates true against the current cart.","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)$"},"expression":{"type":"array","items":{"type":"object","properties":{"query":{"type":"object","properties":{"key":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"type":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"filter":{"type":"string","enum":["includes","doesNotInclude","greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string"},"inclusionType":{"type":"string","enum":["include","exclude"]}},"required":["variantId","inclusionType"],"additionalProperties":false}}}]}},"required":["key","type","filter"],"additionalProperties":false},"operator":{"type":"string","enum":["and","or","start_paren","end_paren"]}},"additionalProperties":false}}},"required":["id","expression"],"additionalProperties":false},"variables":{"type":"object","properties":{"headerText":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]},"maxProductLimit":{"default":3,"type":"integer","minimum":1,"maximum":10},"excludeItemsInCart":{"default":false,"type":"boolean"},"excludeOutOfStock":{"default":false,"type":"boolean"},"buttonText":{"type":"string"},"imageSize":{"type":"number","minimum":1,"maximum":500},"imageSizeUnit":{"type":"string","enum":["pixels","percentage"]},"imageAspectRatio":{"type":"string"},"mediaSpacing":{"type":"string"},"discount":{"type":"object","properties":{"discountType":{"default":"none","type":"string","enum":["none","percentage","fixed"]},"discountValue":{"type":["number","null"]},"compareAtPriceDisplay":{"default":"none","type":"string","enum":["none","compareAtPrice","regularPrice"]}},"required":["discountType","compareAtPriceDisplay"],"additionalProperties":false}},"required":["headerText","maxProductLimit","excludeItemsInCart","excludeOutOfStock","buttonText","imageSize","imageSizeUnit","imageAspectRatio","mediaSpacing"],"additionalProperties":false,"description":"Configurable content for the upsell block (e.g., product selection, heading text, CTA label)."},"styles":{"type":"object","properties":{"typography":{"type":"object","properties":{"header":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"productTitle":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"variantTitle":{"default":{"fontSize":"base","fontStyle":"normal"},"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"price":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"button":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false}},"required":["header","productTitle","variantTitle","price","button"],"additionalProperties":false},"backgroundColors":{"type":"object","properties":{"header":{"type":"string"},"item":{"type":"string"},"block":{"type":"string"},"button":{"default":"auto","type":"string"},"productUnit":{"type":"string"}},"required":["header","item","block","button","productUnit"],"additionalProperties":false},"colors":{"type":"object","properties":{"headerText":{"type":"string"},"productText":{"type":"string"},"variantText":{"default":"subdued","type":"string"},"priceText":{"type":"string"},"carouselArrowColor":{"default":"auto","type":"string"},"carouselArrowStyle":{"default":"primary","type":"string"}},"required":["headerText","productText","variantText","priceText","carouselArrowColor","carouselArrowStyle"],"additionalProperties":false},"layout":{"type":"object","properties":{"headerTextAlign":{"type":"string"},"bodyAlign":{"type":"string"},"itemTextAlign":{"type":"string"},"itemPositionAlign":{"type":"string"},"mobile":{"type":"object","properties":{"rowCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"columnCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["rowCount","columnCount"],"additionalProperties":false},"desktop":{"type":"object","properties":{"rowCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"columnCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["rowCount","columnCount"],"additionalProperties":false}},"required":["headerTextAlign","bodyAlign","itemTextAlign","itemPositionAlign","mobile","desktop"],"additionalProperties":false},"appearance":{"type":"object","properties":{"headerBorderThickness":{"type":"string"},"headerBorderStyle":{"default":"none","type":"string"},"headerCornerRadius":{"type":"string"},"headerPadding":{"type":"string"},"bodySpacing":{"type":"string"},"headingToBodySpacing":{"type":"string"},"blockBorderThickness":{"type":"string"},"blockBorderStyle":{"default":"none","type":"string"},"blockPadding":{"type":"string"},"blockCornerRadius":{"type":"string"},"productBorderThickness":{"type":"string"},"productBorderStyle":{"default":"none","type":"string"},"productCornerRadius":{"type":"string"},"productTextSpacing":{"type":"string"}},"required":["headerBorderThickness","headerBorderStyle","headerCornerRadius","headerPadding","bodySpacing","headingToBodySpacing","blockBorderThickness","blockBorderStyle","blockPadding","blockCornerRadius","productBorderThickness","productBorderStyle","productCornerRadius","productTextSpacing"],"additionalProperties":false}},"required":["typography","backgroundColors","colors","layout","appearance"],"additionalProperties":false,"description":"CSS styling overrides for the upsell block appearance."},"upsellProductRules":{"default":[],"description":"Product selection and recommendation rules that determine which products to show in this upsell block.","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)$"},"checkoutBlockId":{"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)$"},"priority":{"type":"integer","minimum":0,"maximum":9007199254740991},"cartTargeting":{"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)$"},"expression":{"type":"array","items":{"type":"object","properties":{"query":{"type":"object","properties":{"key":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"type":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"filter":{"type":"string","enum":["includes","doesNotInclude","greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string"},"inclusionType":{"type":"string","enum":["include","exclude"]}},"required":["variantId","inclusionType"],"additionalProperties":false}}}]}},"required":["key","type","filter"],"additionalProperties":false},"operator":{"type":"string","enum":["and","or","start_paren","end_paren"]}},"additionalProperties":false}}},"required":["id","expression"],"additionalProperties":false},"action":{"$ref":"#/components/schemas/__schema0"},"variationId":{"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)$"}},"required":["id","checkoutBlockId","priority","cartTargeting","action","variationId"],"additionalProperties":false}},"agenticLogicPlacementId":{"description":"Agentic Logic placement this block evaluates through. Absent means the legacy rule engine serves it — clearing the mapping is the per-surface rollback.","anyOf":[{"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":"null"}]},"agenticLogicRuleId":{"description":"WRITE-SIDE intent: the Agentic Logic rule this block should serve. The experience save upserts the placement and the (placement, variation) assignment from it and stamps `agenticLogicPlacementId`, so callers never assemble that pair themselves. Null detaches the block and returns it to the legacy engine. Reads echo the rule currently assigned.","anyOf":[{"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":"null"}]}},"required":["id","variationId","locationId","blockType","name","variables","styles","upsellProductRules"],"additionalProperties":false},{"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)$","description":"Server-generated. Read-only."},"variationId":{"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":"References the parent variation."},"locationId":{"type":"string","description":"Shopify checkout extensibility target location where the block renders."},"blockType":{"type":"string","const":"shippingProgressBar"},"blockTemplate":{"description":"The template preset this block was created from, within its block type. Null on blocks saved before templates were persisted, which callers must treat as unknown rather than assuming a default.","anyOf":[{"type":"string","enum":["minimal","milestones"]},{"type":"null"}]},"name":{"type":"string","description":"Display name for identifying this block in the dashboard."},"displayConditions":{"description":"Optional cart-based conditions; the block renders only when the expression evaluates true against the current cart.","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)$"},"expression":{"type":"array","items":{"type":"object","properties":{"query":{"type":"object","properties":{"key":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"type":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"filter":{"type":"string","enum":["includes","doesNotInclude","greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string"},"inclusionType":{"type":"string","enum":["include","exclude"]}},"required":["variantId","inclusionType"],"additionalProperties":false}}}]}},"required":["key","type","filter"],"additionalProperties":false},"operator":{"type":"string","enum":["and","or","start_paren","end_paren"]}},"additionalProperties":false}}},"required":["id","expression"],"additionalProperties":false},"variables":{"type":"object","properties":{"headerText":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]},"currency":{"type":"string"},"template":{"default":"minimal","type":"string","enum":["minimal","milestones"]},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"threshold":{"type":"number","exclusiveMinimum":0},"message":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]},"messageComplete":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]},"activeIconId":{"type":"string"},"inactiveIconId":{"type":"string"},"breakpointText":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]}},"required":["threshold","message","messageComplete"],"additionalProperties":false}}},"required":["currency","template","tiers"],"additionalProperties":false},"styles":{"type":"object","properties":{"typography":{"type":"object","properties":{"header":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"label":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false}},"required":["header","label"],"additionalProperties":false},"backgroundColors":{"type":"object","properties":{"header":{"type":"string"},"item":{"type":"string"},"block":{"type":"string"},"milestoneIcon":{"default":"subdued","type":"string"}},"required":["header","item","block","milestoneIcon"],"additionalProperties":false},"colors":{"type":"object","properties":{"headerText":{"type":"string"},"labelText":{"type":"string"},"barTone":{"type":"string"}},"required":["headerText","labelText","barTone"],"additionalProperties":false},"layout":{"type":"object","properties":{"headerTextAlign":{"type":"string"},"bodyAlign":{"type":"string"},"itemTextAlign":{"type":"string"},"itemPositionAlign":{"type":"string"},"messageTextAlign":{"default":"center","type":"string"}},"required":["headerTextAlign","bodyAlign","itemTextAlign","itemPositionAlign","messageTextAlign"],"additionalProperties":false},"appearance":{"type":"object","properties":{"headerBorderThickness":{"type":"string"},"headerBorderStyle":{"default":"none","type":"string"},"headerCornerRadius":{"type":"string"},"headerPadding":{"type":"string"},"bodySpacing":{"type":"string"},"headingToBodySpacing":{"type":"string"},"blockBorderThickness":{"type":"string"},"blockBorderStyle":{"default":"none","type":"string"},"blockPadding":{"type":"string"},"blockCornerRadius":{"type":"string"},"milestoneIconCornerRadius":{"default":"fullyRounded","type":"string"},"milestoneIconSize":{"default":"base","type":"string"},"milestoneIconPadding":{"default":"tight","type":"string"}},"required":["headerBorderThickness","headerBorderStyle","headerCornerRadius","headerPadding","bodySpacing","headingToBodySpacing","blockBorderThickness","blockBorderStyle","blockPadding","blockCornerRadius","milestoneIconCornerRadius","milestoneIconSize","milestoneIconPadding"],"additionalProperties":false}},"required":["typography","backgroundColors","colors","layout","appearance"],"additionalProperties":false}},"required":["id","variationId","locationId","blockType","name","variables","styles"],"additionalProperties":false},{"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)$","description":"Server-generated. Read-only."},"variationId":{"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":"References the parent variation."},"locationId":{"type":"string","description":"Shopify checkout extensibility target location where the block renders."},"blockType":{"type":"string","const":"timer"},"blockTemplate":{"description":"The template preset this block was created from, within its block type. Null on blocks saved before templates were persisted, which callers must treat as unknown rather than assuming a default.","anyOf":[{"type":"string","enum":["textCountdown","digitalClock","inlinePill"]},{"type":"null"}]},"name":{"type":"string","description":"Display name for identifying this block in the dashboard."},"displayConditions":{"description":"Optional cart-based conditions; the block renders only when the expression evaluates true against the current cart.","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)$"},"expression":{"type":"array","items":{"type":"object","properties":{"query":{"type":"object","properties":{"key":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"type":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"filter":{"type":"string","enum":["includes","doesNotInclude","greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string"},"inclusionType":{"type":"string","enum":["include","exclude"]}},"required":["variantId","inclusionType"],"additionalProperties":false}}}]}},"required":["key","type","filter"],"additionalProperties":false},"operator":{"type":"string","enum":["and","or","start_paren","end_paren"]}},"additionalProperties":false}}},"required":["id","expression"],"additionalProperties":false},"variables":{"type":"object","properties":{"timerMode":{"default":"fixedDate","type":"string","enum":["fixedDate","perVisitor","recurring"]},"endDateTime":{"type":["string","null"]},"durationMinutes":{"default":15,"type":"integer","minimum":1,"maximum":9007199254740991},"resetIntervalUnit":{"anyOf":[{"type":"string","enum":["hour","day","week"]},{"type":"null"}]},"resetTimeOfDay":{"anyOf":[{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},{"type":"null"}]},"resetDayOfWeek":{"anyOf":[{"anyOf":[{"type":"number","const":1},{"type":"number","const":2},{"type":"number","const":3},{"type":"number","const":4},{"type":"number","const":5},{"type":"number","const":6},{"type":"number","const":7}]},{"type":"null"}]},"resetMinuteOfHour":{"anyOf":[{"type":"integer","minimum":0,"maximum":59},{"type":"null"}]},"resetTimezone":{"type":["string","null"]},"expiredBehavior":{"default":"showText","type":"string","enum":["remove","showText"]},"timerTemplate":{"default":"textCountdown","type":"string","enum":["textCountdown","digitalClock","inlinePill"]},"showDays":{"default":false,"type":"boolean"},"showHours":{"default":true,"type":"boolean"},"showMinutes":{"default":true,"type":"boolean"},"showSeconds":{"default":true,"type":"boolean"},"countdownText":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]},"expiredText":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]},"headline":{"default":"","anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]}},"required":["timerMode","durationMinutes","expiredBehavior","timerTemplate","showDays","showHours","showMinutes","showSeconds","countdownText","expiredText","headline"],"additionalProperties":false},"styles":{"type":"object","properties":{"typography":{"type":"object","properties":{"text":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false}},"required":["text"],"additionalProperties":false},"backgroundColors":{"type":"object","properties":{"block":{"type":"string"},"expired":{"type":"string"}},"required":["block","expired"],"additionalProperties":false},"colors":{"type":"object","properties":{"text":{"type":"string"},"expiredText":{"type":"string"},"digit":{"default":"info","type":"string"}},"required":["text","expiredText","digit"],"additionalProperties":false},"layout":{"type":"object","properties":{"textAlign":{"type":"string"}},"required":["textAlign"],"additionalProperties":false},"appearance":{"type":"object","properties":{"blockBorderStyle":{"default":"none","type":"string"},"blockBorderThickness":{"type":"string"},"blockCornerRadius":{"type":"string"},"blockPadding":{"type":"string"}},"required":["blockBorderStyle","blockBorderThickness","blockCornerRadius","blockPadding"],"additionalProperties":false},"digits":{"default":{"separator":"colon","size":"base"},"type":"object","properties":{"separator":{"default":"colon","type":"string","enum":["colon","dot","units"]},"size":{"default":"base","type":"string","enum":["small","base"]}},"required":["separator","size"],"additionalProperties":false}},"required":["typography","backgroundColors","colors","layout","appearance","digits"],"additionalProperties":false}},"required":["id","variationId","locationId","blockType","name","variables","styles"],"additionalProperties":false},{"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)$","description":"Server-generated. Read-only."},"variationId":{"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":"References the parent variation."},"locationId":{"type":"string","description":"Shopify checkout extensibility target location where the block renders."},"blockType":{"type":"string","const":"faqs"},"blockTemplate":{"description":"The template preset this block was created from, within its block type. Null on blocks saved before templates were persisted, which callers must treat as unknown rather than assuming a default.","anyOf":[{"type":"string","enum":["faqsAccordion"]},{"type":"null"}]},"name":{"type":"string","description":"Display name for identifying this block in the dashboard."},"displayConditions":{"description":"Optional cart-based conditions; the block renders only when the expression evaluates true against the current cart.","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)$"},"expression":{"type":"array","items":{"type":"object","properties":{"query":{"type":"object","properties":{"key":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"type":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"filter":{"type":"string","enum":["includes","doesNotInclude","greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string"},"inclusionType":{"type":"string","enum":["include","exclude"]}},"required":["variantId","inclusionType"],"additionalProperties":false}}}]}},"required":["key","type","filter"],"additionalProperties":false},"operator":{"type":"string","enum":["and","or","start_paren","end_paren"]}},"additionalProperties":false}}},"required":["id","expression"],"additionalProperties":false},"variables":{"type":"object","properties":{"headerText":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]},"showDivider":{"default":true,"type":"boolean"},"allowMultipleOpen":{"default":false,"type":"boolean"},"questions":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"question":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]},"answer":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]},"openByDefault":{"default":false,"type":"boolean"}},"required":["id","question","answer","openByDefault"],"additionalProperties":false}}},"required":["showDivider","allowMultipleOpen","questions"],"additionalProperties":false},"styles":{"type":"object","properties":{"typography":{"type":"object","properties":{"header":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"question":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"answer":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false}},"required":["header","question","answer"],"additionalProperties":false},"backgroundColors":{"type":"object","properties":{"header":{"type":"string"},"item":{"type":"string"},"block":{"type":"string"}},"required":["header","item","block"],"additionalProperties":false},"colors":{"type":"object","properties":{"headerText":{"type":"string"},"questionText":{"type":"string"},"answerText":{"type":"string"}},"required":["headerText","questionText","answerText"],"additionalProperties":false},"layout":{"type":"object","properties":{"headerTextAlign":{"type":"string"},"bodyAlign":{"type":"string"},"itemTextAlign":{"type":"string"},"itemPositionAlign":{"type":"string"}},"required":["headerTextAlign","bodyAlign","itemTextAlign","itemPositionAlign"],"additionalProperties":false},"appearance":{"type":"object","properties":{"headerBorderThickness":{"type":"string"},"headerBorderStyle":{"default":"none","type":"string"},"headerCornerRadius":{"type":"string"},"headerPadding":{"type":"string"},"bodySpacing":{"type":"string"},"headingToBodySpacing":{"type":"string"},"blockBorderThickness":{"type":"string"},"blockBorderStyle":{"default":"none","type":"string"},"blockPadding":{"type":"string"},"blockCornerRadius":{"type":"string"}},"required":["headerBorderThickness","headerBorderStyle","headerCornerRadius","headerPadding","bodySpacing","headingToBodySpacing","blockBorderThickness","blockBorderStyle","blockPadding","blockCornerRadius"],"additionalProperties":false}},"required":["typography","backgroundColors","colors","layout","appearance"],"additionalProperties":false}},"required":["id","variationId","locationId","blockType","name","variables","styles"],"additionalProperties":false},{"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)$","description":"Server-generated. Read-only."},"variationId":{"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":"References the parent variation."},"locationId":{"type":"string","description":"Shopify checkout extensibility target location where the block renders."},"blockType":{"type":"string","const":"postPurchaseUpsell"},"blockTemplate":{"description":"The template preset this block was created from, within its block type. Null on blocks saved before templates were persisted, which callers must treat as unknown rather than assuming a default.","type":"null"},"name":{"type":"string","description":"Display name for identifying this block in the dashboard."},"displayConditions":{"description":"Optional cart-based conditions; the block renders only when the expression evaluates true against the current cart.","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)$"},"expression":{"type":"array","items":{"type":"object","properties":{"query":{"type":"object","properties":{"key":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"type":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"filter":{"type":"string","enum":["includes","doesNotInclude","greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string"},"inclusionType":{"type":"string","enum":["include","exclude"]}},"required":["variantId","inclusionType"],"additionalProperties":false}}}]}},"required":["key","type","filter"],"additionalProperties":false},"operator":{"type":"string","enum":["and","or","start_paren","end_paren"]}},"additionalProperties":false}}},"required":["id","expression"],"additionalProperties":false},"variables":{"type":"object","properties":{"headerText":{"type":"string"},"discountType":{"default":"none","type":"string","enum":["none","percentage","fixed"]},"discountValue":{"type":["number","null"]},"compareAtPriceDisplay":{"default":"none","type":"string","enum":["none","compareAtPrice","regularPrice"]},"imageAspectRatio":{"type":"string"},"excludeOutOfStock":{"type":"boolean"},"excludeItemsInCart":{"type":"boolean"},"maxProductLimit":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"bannerEnabled":{"type":"boolean"},"bannerTitle":{"type":"string"},"bannerSubtitle":{"type":"string"},"customerFirstNameFallback":{"type":"string"},"compareAtPriceEnabled":{"type":"boolean"},"descriptionEnabled":{"type":"boolean"},"quantitySelectorEnabled":{"type":"boolean"},"quantityLabel":{"type":"string"},"maxQuantityType":{"type":"string"},"maxQuantity":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"moneyLineEnabled":{"default":true,"type":"boolean"},"moneyLineSubtotal":{"default":true,"type":"boolean"},"moneyLineShipping":{"default":true,"type":"boolean"},"moneyLineTaxes":{"default":true,"type":"boolean"},"primaryButtonText":{"default":"Accept offer","type":"string"},"secondaryButtonEnabled":{"default":true,"type":"boolean"},"secondaryButtonText":{"default":"Decline this offer","type":"string"},"headingLevel":{"type":"string"},"countdownTimerEnabled":{"type":"boolean"},"timerCheckout":{"type":"object","properties":{"timerMode":{"default":"fixedDate","type":"string","enum":["fixedDate","perVisitor","recurring"]},"endDateTime":{"type":["string","null"]},"durationMinutes":{"default":15,"type":"integer","minimum":1,"maximum":9007199254740991},"resetIntervalUnit":{"anyOf":[{"type":"string","enum":["hour","day","week"]},{"type":"null"}]},"resetTimeOfDay":{"anyOf":[{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},{"type":"null"}]},"resetDayOfWeek":{"anyOf":[{"anyOf":[{"type":"number","const":1},{"type":"number","const":2},{"type":"number","const":3},{"type":"number","const":4},{"type":"number","const":5},{"type":"number","const":6},{"type":"number","const":7}]},{"type":"null"}]},"resetMinuteOfHour":{"anyOf":[{"type":"integer","minimum":0,"maximum":59},{"type":"null"}]},"resetTimezone":{"type":["string","null"]},"expiredBehavior":{"default":"showText","type":"string","enum":["remove","showText"]},"timerTemplate":{"default":"textCountdown","type":"string","enum":["textCountdown","digitalClock","inlinePill"]},"showDays":{"default":false,"type":"boolean"},"showHours":{"default":true,"type":"boolean"},"showMinutes":{"default":true,"type":"boolean"},"showSeconds":{"default":true,"type":"boolean"},"countdownText":{"type":"string"},"expiredText":{"type":"string"},"headline":{"default":"","type":"string"}},"required":["timerMode","durationMinutes","expiredBehavior","timerTemplate","showDays","showHours","showMinutes","showSeconds","countdownText","expiredText","headline"],"additionalProperties":false},"offerTimeout":{"type":"number"},"discount":{"type":"object","properties":{"discountType":{"default":"none","type":"string","enum":["none","percentage","fixed"]},"discountValue":{"type":["number","null"]},"compareAtPriceDisplay":{"default":"none","type":"string","enum":["none","compareAtPrice","regularPrice"]}},"required":["discountType","compareAtPriceDisplay"],"additionalProperties":false}},"required":["headerText","discountType","compareAtPriceDisplay","imageAspectRatio","excludeOutOfStock","excludeItemsInCart","maxProductLimit","bannerEnabled","compareAtPriceEnabled","descriptionEnabled","quantitySelectorEnabled","moneyLineEnabled","moneyLineSubtotal","moneyLineShipping","moneyLineTaxes","primaryButtonText","secondaryButtonEnabled","secondaryButtonText","headingLevel"],"additionalProperties":false},"styles":{"type":"object","properties":{"typography":{"type":"object","properties":{"banner":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"productTitle":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"price":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"description":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"primaryButton":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"secondaryButton":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false}},"required":["productTitle","price","primaryButton"],"additionalProperties":false},"backgroundColors":{"type":"object","properties":{"banner":{"type":"string"},"primaryButton":{"type":"string"},"secondaryButton":{"type":"string"},"countdown":{"type":"string"},"expired":{"type":"string"}},"required":["banner","primaryButton"],"additionalProperties":false},"colors":{"type":"object","properties":{"bannerText":{"type":"string"},"productText":{"type":"string"},"priceText":{"type":"string"},"descriptionText":{"type":"string"},"primaryButtonText":{"type":"string"},"secondaryButtonText":{"type":"string"},"expiredText":{"type":"string"}},"required":["productText","priceText","primaryButtonText"],"additionalProperties":false},"appearance":{"type":"object","properties":{"bannerBorderStyle":{"type":"string"},"bannerSpacing":{"type":"string"},"bannerTextAlign":{"type":"string"},"separatorWidth":{"type":"string"},"imageFit":{"type":"string"},"imageBorder":{"type":"boolean"},"pricingAppearance":{"type":"string"},"pricingEmphasized":{"type":"boolean"},"pricingSubduedStyle":{"type":"boolean"},"descriptionSubdued":{"type":"boolean"},"secondaryButtonStyle":{"type":"string"},"countdownTextAlign":{"type":"string"},"countdownBorderStyle":{"type":"string"},"countdownSpacing":{"type":"string"}},"required":["bannerBorderStyle","bannerSpacing","bannerTextAlign","separatorWidth","imageFit","imageBorder","pricingEmphasized","descriptionSubdued","secondaryButtonStyle"],"additionalProperties":false}},"required":["typography","backgroundColors","colors","appearance"],"additionalProperties":false},"upsellProductRules":{"default":[],"description":"Product selection and recommendation rules that determine which products to show in this upsell block.","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)$"},"checkoutBlockId":{"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)$"},"priority":{"type":"integer","minimum":0,"maximum":9007199254740991},"cartTargeting":{"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)$"},"expression":{"type":"array","items":{"type":"object","properties":{"query":{"type":"object","properties":{"key":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"type":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"filter":{"type":"string","enum":["includes","doesNotInclude","greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string"},"inclusionType":{"type":"string","enum":["include","exclude"]}},"required":["variantId","inclusionType"],"additionalProperties":false}}}]}},"required":["key","type","filter"],"additionalProperties":false},"operator":{"type":"string","enum":["and","or","start_paren","end_paren"]}},"additionalProperties":false}}},"required":["id","expression"],"additionalProperties":false},"action":{"$ref":"#/components/schemas/__schema0"},"variationId":{"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)$"}},"required":["id","checkoutBlockId","priority","cartTargeting","action","variationId"],"additionalProperties":false}},"agenticLogicPlacementId":{"description":"Agentic Logic placement this block evaluates through. Absent means the legacy rule engine serves it — clearing the mapping is the per-surface rollback.","anyOf":[{"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":"null"}]},"agenticLogicRuleId":{"description":"WRITE-SIDE intent: the Agentic Logic rule this block should serve. The experience save upserts the placement and the (placement, variation) assignment from it and stamps `agenticLogicPlacementId`, so callers never assemble that pair themselves. Null detaches the block and returns it to the legacy engine. Reads echo the rule currently assigned.","anyOf":[{"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":"null"}]}},"required":["id","variationId","locationId","blockType","name","variables","styles","upsellProductRules"],"additionalProperties":false}],"type":"object"}}},"required":["variationId","name","isControl","blocks"],"additionalProperties":false},"description":"The experience's variations, each with its checkout blocks."}},"required":["variations"],"additionalProperties":false}}}},"429":{"description":"Too Many Requests","headers":{"access-control-allow-origin":{"schema":{"type":"string"},"description":"CORS allow-origin header."},"access-control-allow-credentials":{"schema":{"type":"string"},"description":"CORS allow-credentials header."},"content-type":{"schema":{"type":"string"},"description":"Response content type."},"X-RateLimit-Limit":{"schema":{"type":"string"},"description":"Maximum requests allowed in the current window."},"X-RateLimit-Remaining":{"schema":{"type":"string"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"string"},"description":"Unix timestamp (ms) when the rate limit resets."},"Retry-After":{"schema":{"type":"string"},"description":"Seconds to wait before retrying after a rate limit hit."}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"retryAfter":{"type":"number"}},"required":["error","message"]}}}}}}}}}
````

## Add checkout block

> Adds a checkout block to one of an experience's variations.\
> \
> The block starts from its template's defaults. Send only what you want to change, at any depth: every field of \`variables\` and \`styles\` you leave out keeps the template's value. A list you send, such as a trust badge's \`items\` or an FAQ block's \`questions\`, replaces the template's list whole.\
> \
> \### Required Fields\
> \
> \- \`blockType\` (string) — The block type (see the list above)\
> \- \`variationId\` (UUID) — The variation to add the block to. It must belong to the experience in the path.\
> \
> \### Optional Fields\
> \
> \- \`name\` (string) — Display name in the dashboard. Defaults to the template's name and the block's position.\
> \- \`template\` (string) — The preset to start from. The values depend on \`blockType\`. Not accepted for \`postPurchaseUpsell\`.\
> \- \`variables\` (object) — Content settings for this block type\
> \- \`styles\` (object) — Style settings for this block type\
> \- \`displayConditions\` (object) — Cart conditions that decide when the block shows. Omit it to show the block on every cart. Not accepted for \`postPurchaseUpsell\`.\
> \- \`upsellProductRules\` (array) — Which products the block recommends. \`upsell\` and \`postPurchaseUpsell\` only. Leave it out to start with Shopify's recommendations on every cart or order, the same as a block added in Intelligems.\
> \
> \### Response\
> \
> \`{ "block": { ... } }\`, with the saved block. A \`postPurchaseUpsell\` block also returns \`adjustments\`, listing anything the API changed on its own to keep the offer valid. An \`upsell\` block sent without \`upsellProductRules\` returns \`adjustments\` too, saying which products it starts with.\
> \
> \### Important Notes\
> \
> \- Blocks can only be added to a \`checkoutBlock\`, \`postPurchase\` or \`personalization\` experience, the same as in Intelligems. Adding one to any other experience, such as a price or offer test, returns a \`400\`.\
> \- A \`postPurchaseUpsell\` block needs a store that is ready for post-purchase upsells. If it isn't, the request returns a \`400\` listing what to fix.\
> \- Discounts can't be set with an API key. An upsell's \`variables.discount\`, a product rule's \`discount\`, and a post-purchase upsell's \`discountType\` and \`discountValue\` return a \`400\`. Set discounts in Intelligems.\
> \- On a store that uses Agentic Logic, a new \`upsell\` or \`postPurchaseUpsell\` block shows products from the store's built-in "Shopify recommendations" rule, the same as one added in Intelligems. Its products come from that rule, so \`upsellProductRules\` returns a \`400\` there. To show different products, pick another rule in Intelligems.\
> \- A recurring timer's \`resetTimezone\` is set to the store's timezone. If the store has none, send one: it has to be an IANA name such as \`America/New\_York\`, or the request returns a \`400\`.\
> \- Blocks added to a running experience show to shoppers immediately.\
> \
> \*\*Rate Limit:\*\* 50 requests per 30s window, refilling 25 tokens every 30s.

```json
{"openapi":"3.1.0","info":{"title":"Intelligems External API v25-10-beta","version":"v25-10-beta"},"tags":[{"name":"Manage Checkout Blocks","description":"Checkout blocks are the content a `checkoutBlock` or `postPurchase` experience tests. Each block belongs to one variation. The following block types are supported:\n\n- `trustBadge` — Trust badges, guarantees, or brand logos\n- `upsell` — Product recommendations in checkout\n- `shippingProgressBar` — Progress toward free shipping\n- `timer` — A countdown timer\n- `faqs` — Collapsible questions and answers\n- `postPurchaseUpsell` — A one-click offer shown after checkout\n\n`blockType` picks which `variables` (content settings), `styles`, and `template` values a request accepts. Unknown fields are rejected with a `400` that names the field.\n\n**Create vs. replace.** `POST` keeps the template's value for every field you leave out, at any depth, so a minimal body creates a complete block. `PUT` replaces the block's content: `name`, `variables`, and `styles` are required, and every field you leave out, at any depth, resets to the template's value instead of keeping the saved one. The exception is `postPurchaseUpsell`: its `PUT` merges the fields you send onto the saved block. A post-purchase upsell may also adjust related settings on its own to stay valid, and lists what it changed in the response's `adjustments`.\n\n**Post-purchase readiness.** Adding a `postPurchaseUpsell` block checks that the store is ready for post-purchase upsells (plan, Shopify permissions, and settings), and returns a `400` listing what to fix if it isn't. API keys get no exemption from this check. Replacing an existing post-purchase upsell with `PUT` doesn't re-run it.\n\n**Discounts.** Discounts can't be set with an API key. Set an offer's discount in Intelligems, or through the Intelligems MCP while signed in. A request that sends one gets a `400`: that's an upsell's `variables.discount`, a product rule's `discount`, or a post-purchase upsell's `discountType` or `discountValue`. A `PUT` keeps the discount saved on the block, along with the settings that decide who gets it: the block's product rules and display conditions, `maxProductLimit` and `excludeItemsInCart`, and a post-purchase upsell's `maxQuantityType` and `maxQuantity`. Changing any of those on a discounted block returns a `400`. You can still rename a discounted block, change its copy and styles, and change a post-purchase upsell's `compareAtPriceDisplay`, which only changes the struck-through price shown. A block without a discount takes any change.\n\n**Display conditions and upsell rules.** `displayConditions` (when a block shows) and `upsellProductRules` (which products an `upsell` or `postPurchaseUpsell` block recommends) are written as a flat list of conditions joined by `match: \"all\"` or `\"any\"`. On `PUT`, omit a field to keep its current value, send `null` to remove it, or send a value to replace it. `postPurchaseUpsell` blocks don't use display conditions, and only `upsell` and `postPurchaseUpsell` blocks take product rules.\n\n**Reading blocks back.** `GET` returns the blocks as they are stored. Stored display conditions and product rules are in the compiled form the storefront evaluates, not the condition-list form you send, so don't send them back on `PUT`.\n\n**Live tests.** You can add, change, and delete blocks on a running experience. Changes take effect for shoppers immediately.\n\nYour organization's plan must include checkout block tests; otherwise every checkout-block endpoint returns a `403`."}],"servers":[{"url":"https://api.intelligems.io","description":"Production"}],"security":[{"intelligems_access_token":[]}],"components":{"securitySchemes":{"intelligems_access_token":{"type":"apiKey","in":"header","name":"intelligems-access-token","description":"Intelligems external API access token."}},"schemas":{"__schema0":{"type":"object","properties":{"discountType":{"default":"none","type":"string","enum":["none","percentage","fixed"]},"discountValue":{"type":["number","null"]},"compareAtPriceDisplay":{"default":"none","type":"string","enum":["none","compareAtPrice","regularPrice"]},"expression":{"type":"array","items":{"type":"object","properties":{"query":{"type":"object","properties":{"key":{"type":"string","enum":["shopifyRecommendations","productId","collection","tag"]},"type":{"type":"string","enum":["shopifyRecommendations","productId","collection","tag"]},"filter":{"type":"string","enum":["includes","doesNotInclude"]},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"array","items":{"type":"object","properties":{"order":{"type":"number"},"productId":{"type":"string"},"productTitle":{"type":"string"},"handle":{"type":["string","null"]},"productImage":{"type":["string","null"]},"description":{"type":["string","null"]},"options":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"values":{"type":"array","items":{"type":"string"}}},"required":["name","values"],"additionalProperties":false}},"variants":{"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string"},"variantTitle":{"type":"string"},"variantImage":{"type":["string","null"]},"price":{"type":"number"},"compareAtPrice":{"type":["number","null"]},"currencyCode":{"type":"string"},"availableForSale":{"type":"boolean"},"sig":{"type":["string","null"]},"inclusionType":{"type":"string","enum":["include","exclude"]},"variantOptions":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"}},"required":["name","value"],"additionalProperties":false}}},"required":["variantId","variantTitle","price","inclusionType"],"additionalProperties":false}},"defaultVariantId":{"type":["string","null"]}},"required":["order","productId","productTitle","variants"],"additionalProperties":false}}]}},"required":["key","type"],"additionalProperties":false},"operator":{"type":"string","enum":["and","or","start_paren","end_paren"]}},"additionalProperties":false}},"onAccept":{"anyOf":[{"$ref":"#/components/schemas/__schema0"},{"type":"null"}]},"onDecline":{"anyOf":[{"$ref":"#/components/schemas/__schema0"},{"type":"null"}]}},"required":["discountType","compareAtPriceDisplay","expression"],"additionalProperties":false}}},"paths":{"/v25-10-beta/experiences/{experienceId}/checkout-blocks":{"post":{"operationId":"postCheckoutBlock","summary":"Add checkout block","tags":["Manage Checkout Blocks"],"description":"Adds a checkout block to one of an experience's variations.\n\nThe block starts from its template's defaults. Send only what you want to change, at any depth: every field of `variables` and `styles` you leave out keeps the template's value. A list you send, such as a trust badge's `items` or an FAQ block's `questions`, replaces the template's list whole.\n\n### Required Fields\n\n- `blockType` (string) — The block type (see the list above)\n- `variationId` (UUID) — The variation to add the block to. It must belong to the experience in the path.\n\n### Optional Fields\n\n- `name` (string) — Display name in the dashboard. Defaults to the template's name and the block's position.\n- `template` (string) — The preset to start from. The values depend on `blockType`. Not accepted for `postPurchaseUpsell`.\n- `variables` (object) — Content settings for this block type\n- `styles` (object) — Style settings for this block type\n- `displayConditions` (object) — Cart conditions that decide when the block shows. Omit it to show the block on every cart. Not accepted for `postPurchaseUpsell`.\n- `upsellProductRules` (array) — Which products the block recommends. `upsell` and `postPurchaseUpsell` only. Leave it out to start with Shopify's recommendations on every cart or order, the same as a block added in Intelligems.\n\n### Response\n\n`{ \"block\": { ... } }`, with the saved block. A `postPurchaseUpsell` block also returns `adjustments`, listing anything the API changed on its own to keep the offer valid. An `upsell` block sent without `upsellProductRules` returns `adjustments` too, saying which products it starts with.\n\n### Important Notes\n\n- Blocks can only be added to a `checkoutBlock`, `postPurchase` or `personalization` experience, the same as in Intelligems. Adding one to any other experience, such as a price or offer test, returns a `400`.\n- A `postPurchaseUpsell` block needs a store that is ready for post-purchase upsells. If it isn't, the request returns a `400` listing what to fix.\n- Discounts can't be set with an API key. An upsell's `variables.discount`, a product rule's `discount`, and a post-purchase upsell's `discountType` and `discountValue` return a `400`. Set discounts in Intelligems.\n- On a store that uses Agentic Logic, a new `upsell` or `postPurchaseUpsell` block shows products from the store's built-in \"Shopify recommendations\" rule, the same as one added in Intelligems. Its products come from that rule, so `upsellProductRules` returns a `400` there. To show different products, pick another rule in Intelligems.\n- A recurring timer's `resetTimezone` is set to the store's timezone. If the store has none, send one: it has to be an IANA name such as `America/New_York`, or the request returns a `400`.\n- Blocks added to a running experience show to shoppers immediately.\n\n**Rate Limit:** 50 requests per 30s window, refilling 25 tokens every 30s.","parameters":[{"in":"path","name":"experienceId","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)$","description":"The experience the checkout block belongs to."},"required":true,"description":"The experience the checkout block belongs to."}],"requestBody":{"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"blockType":{"type":"string","const":"trustBadge","description":"The block type. Picks which `variables`, `styles` and `template` values are accepted. A PUT can't change a block's type."},"variationId":{"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":"The variation the block is added to. It must belong to the experience in the path."},"name":{"description":"Display name for identifying this block in the dashboard.","type":"string"},"template":{"description":"The preset the block's defaults are seeded from. Values depend on `blockType`. Omit it to use the type's default preset.","type":"string","enum":["badgeList","badgeTiles","callOut","grid","header","images","brandLogo","textOnly"]},"variables":{"description":"Content settings for this block type. Send only the fields you want to set, at any depth; every field you leave out keeps the template's value. A list you send replaces the template's list whole. Unknown fields are rejected. An upsell's `discount` can't be set with an API key: set it in Intelligems.","type":"object","properties":{"headerText":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"]}},"required":["text"]}}]},"items":{"type":"array","items":{"type":"object","properties":{"order":{"type":"number"},"title":{"anyOf":[{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"]}},"required":["text"]}}]},{"type":"null"}]},"subtitle":{"anyOf":[{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"]}},"required":["text"]}}]},{"type":"null"}]},"type":{"type":"string"},"icon":{"type":["string","null"]},"iconColor":{"type":["string","null"]},"iconSize":{"type":["string","null"]},"imageSize":{"anyOf":[{"type":"number","minimum":1,"maximum":500},{"type":"null"}]},"imageSizeUnit":{"type":"string","enum":["pixels","percentage"]},"imageAspectRatio":{"type":["string","null"]},"image":{"type":["string","null"]},"mediaSpacing":{"type":"string"}},"required":["order","type","imageSize","imageSizeUnit","mediaSpacing"]}}},"additionalProperties":false},"styles":{"description":"Style settings for this block type. Send only the groups and fields you want to set, at any depth; everything you leave out keeps the template's value. Unknown groups and fields are rejected.","type":"object","properties":{"typography":{"type":"object","properties":{"header":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"additionalProperties":false},"itemTitle":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"additionalProperties":false},"itemSubtitle":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false},"backgroundColors":{"type":"object","properties":{"header":{"type":"string"},"item":{"type":"string"},"block":{"type":"string"}},"additionalProperties":false},"colors":{"type":"object","properties":{"headerText":{"type":"string"},"itemTitleText":{"type":"string"},"itemSubtitleText":{"type":"string"}},"additionalProperties":false},"layout":{"type":"object","properties":{"headerTextAlign":{"type":"string"},"bodyAlign":{"type":"string"},"itemTextAlign":{"type":"string"},"itemPositionAlign":{"type":"string"},"rowCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"columnCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"additionalProperties":false},"appearance":{"type":"object","properties":{"headerBorderThickness":{"type":"string"},"headerBorderStyle":{"type":"string"},"headerCornerRadius":{"type":"string"},"headerPadding":{"type":"string"},"bodySpacing":{"type":"string"},"headingToBodySpacing":{"type":"string"},"blockBorderThickness":{"type":"string"},"blockBorderStyle":{"type":"string"},"blockPadding":{"type":"string"},"blockCornerRadius":{"type":"string"},"itemBorderThickness":{"type":"string"},"itemBorderStyle":{"type":"string"},"itemCornerRadius":{"type":"string"},"itemTextSpacing":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false},"displayConditions":{"description":"Cart conditions that decide when the block shows. Omit it to show the block on every cart.","type":"object","properties":{"match":{"default":"all","description":"`all` = every condition must hold (AND). `any` = at least one (OR).","type":"string","enum":["all","any"]},"conditions":{"minItems":1,"type":"array","items":{"oneOf":[{"type":"object","properties":{"attribute":{"type":"string","const":"anything"}},"required":["attribute"]},{"type":"object","properties":{"attribute":{"type":"string","const":"cartSubtotal"},"operator":{"type":"string","enum":["greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"type":"number","description":"Subtotal to compare against, in the shop's currency (e.g. 50 for $50). For `between`, this is the lower bound."},"valueMax":{"description":"Upper bound. Required for `between`, ignored otherwise.","type":"number"}},"required":["attribute","operator","value"]},{"type":"object","properties":{"attribute":{"type":"string","const":"cartItemCount"},"operator":{"type":"string","enum":["greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Item count to compare against. For `between`, the lower bound."},"valueMax":{"description":"Upper bound. Required for `between`, ignored otherwise.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["attribute","operator","value"]},{"type":"object","properties":{"attribute":{"type":"string","const":"collection"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"collectionIds":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Collection ids the cart must (or must not) contain a product from. Numeric ids or gids from list_collections — the server normalizes them. A title or handle is rejected; look the collection up first."}},"required":["attribute","collectionIds"]},{"type":"object","properties":{"attribute":{"type":"string","const":"tag"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"tags":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Product tags the cart must (or must not) contain."}},"required":["attribute","tags"]},{"type":"object","properties":{"attribute":{"type":"string","const":"subscription"},"operator":{"default":"includes","description":"`includes` = cart has at least one subscription line; `doesNotInclude` = none.","type":"string","enum":["includes","doesNotInclude"]}},"required":["attribute"]},{"type":"object","properties":{"attribute":{"type":"string","const":"productId"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"products":{"minItems":1,"type":"array","items":{"type":"object","properties":{"productId":{"type":"string","description":"Shopify product id. Numeric id or gid — the server normalizes it."},"variantIds":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Variant ids of this product that count as a match. Required: a product entry with no variants can never match a cart. Get them with get_product (one call per product, works on every store) and pass all of them unless the merchant named specific variants; search_products isn't available on every store."}},"required":["productId","variantIds"]}}},"required":["attribute","products"]}],"description":"One cart condition. `anything` matches every cart and cannot be combined with other conditions.","type":"object"},"description":"The full condition list. This REPLACES the existing conditions wholesale — to add a second condition to a block, send both the existing one and the new one."}},"required":["conditions"]}},"required":["blockType","variationId"],"additionalProperties":false},{"type":"object","properties":{"blockType":{"type":"string","const":"upsell","description":"The block type. Picks which `variables`, `styles` and `template` values are accepted. A PUT can't change a block's type."},"variationId":{"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":"The variation the block is added to. It must belong to the experience in the path."},"name":{"description":"Display name for identifying this block in the dashboard.","type":"string"},"template":{"description":"The preset the block's defaults are seeded from. Values depend on `blockType`. Omit it to use the type's default preset.","type":"string","enum":["productTiles","productList","singleProduct","singleProductCheckbox"]},"variables":{"description":"Content settings for this block type. Send only the fields you want to set, at any depth; every field you leave out keeps the template's value. A list you send replaces the template's list whole. Unknown fields are rejected. An upsell's `discount` can't be set with an API key: set it in Intelligems.","type":"object","properties":{"headerText":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"]}},"required":["text"]}}]},"maxProductLimit":{"type":"integer","minimum":1,"maximum":10},"excludeItemsInCart":{"type":"boolean"},"excludeOutOfStock":{"type":"boolean"},"buttonText":{"type":"string"},"imageSize":{"type":"number","minimum":1,"maximum":500},"imageSizeUnit":{"type":"string","enum":["pixels","percentage"]},"imageAspectRatio":{"type":"string"},"mediaSpacing":{"type":"string"},"discount":{"description":"Not accepted with an API key. Discounts are set in Intelligems, or through the Intelligems MCP while signed in; a PUT keeps the saved discount.","not":{}}},"additionalProperties":false},"styles":{"description":"Style settings for this block type. Send only the groups and fields you want to set, at any depth; everything you leave out keeps the template's value. Unknown groups and fields are rejected.","type":"object","properties":{"typography":{"type":"object","properties":{"header":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"additionalProperties":false},"productTitle":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"additionalProperties":false},"variantTitle":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"additionalProperties":false},"price":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"additionalProperties":false},"button":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false},"backgroundColors":{"type":"object","properties":{"header":{"type":"string"},"item":{"type":"string"},"block":{"type":"string"},"button":{"type":"string"},"productUnit":{"type":"string"}},"additionalProperties":false},"colors":{"type":"object","properties":{"headerText":{"type":"string"},"productText":{"type":"string"},"variantText":{"type":"string"},"priceText":{"type":"string"},"carouselArrowColor":{"type":"string"},"carouselArrowStyle":{"type":"string"}},"additionalProperties":false},"layout":{"type":"object","properties":{"headerTextAlign":{"type":"string"},"bodyAlign":{"type":"string"},"itemTextAlign":{"type":"string"},"itemPositionAlign":{"type":"string"},"mobile":{"type":"object","properties":{"rowCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"columnCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"additionalProperties":false},"desktop":{"type":"object","properties":{"rowCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"columnCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"additionalProperties":false}},"additionalProperties":false},"appearance":{"type":"object","properties":{"headerBorderThickness":{"type":"string"},"headerBorderStyle":{"type":"string"},"headerCornerRadius":{"type":"string"},"headerPadding":{"type":"string"},"bodySpacing":{"type":"string"},"headingToBodySpacing":{"type":"string"},"blockBorderThickness":{"type":"string"},"blockBorderStyle":{"type":"string"},"blockPadding":{"type":"string"},"blockCornerRadius":{"type":"string"},"productBorderThickness":{"type":"string"},"productBorderStyle":{"type":"string"},"productCornerRadius":{"type":"string"},"productTextSpacing":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false},"displayConditions":{"description":"Cart conditions that decide when the block shows. Omit it to show the block on every cart.","type":"object","properties":{"match":{"default":"all","description":"`all` = every condition must hold (AND). `any` = at least one (OR).","type":"string","enum":["all","any"]},"conditions":{"minItems":1,"type":"array","items":{"oneOf":[{"type":"object","properties":{"attribute":{"type":"string","const":"anything"}},"required":["attribute"]},{"type":"object","properties":{"attribute":{"type":"string","const":"cartSubtotal"},"operator":{"type":"string","enum":["greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"type":"number","description":"Subtotal to compare against, in the shop's currency (e.g. 50 for $50). For `between`, this is the lower bound."},"valueMax":{"description":"Upper bound. Required for `between`, ignored otherwise.","type":"number"}},"required":["attribute","operator","value"]},{"type":"object","properties":{"attribute":{"type":"string","const":"cartItemCount"},"operator":{"type":"string","enum":["greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Item count to compare against. For `between`, the lower bound."},"valueMax":{"description":"Upper bound. Required for `between`, ignored otherwise.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["attribute","operator","value"]},{"type":"object","properties":{"attribute":{"type":"string","const":"collection"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"collectionIds":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Collection ids the cart must (or must not) contain a product from. Numeric ids or gids from list_collections — the server normalizes them. A title or handle is rejected; look the collection up first."}},"required":["attribute","collectionIds"]},{"type":"object","properties":{"attribute":{"type":"string","const":"tag"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"tags":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Product tags the cart must (or must not) contain."}},"required":["attribute","tags"]},{"type":"object","properties":{"attribute":{"type":"string","const":"subscription"},"operator":{"default":"includes","description":"`includes` = cart has at least one subscription line; `doesNotInclude` = none.","type":"string","enum":["includes","doesNotInclude"]}},"required":["attribute"]},{"type":"object","properties":{"attribute":{"type":"string","const":"productId"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"products":{"minItems":1,"type":"array","items":{"type":"object","properties":{"productId":{"type":"string","description":"Shopify product id. Numeric id or gid — the server normalizes it."},"variantIds":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Variant ids of this product that count as a match. Required: a product entry with no variants can never match a cart. Get them with get_product (one call per product, works on every store) and pass all of them unless the merchant named specific variants; search_products isn't available on every store."}},"required":["productId","variantIds"]}}},"required":["attribute","products"]}],"description":"One cart condition. `anything` matches every cart and cannot be combined with other conditions.","type":"object"},"description":"The full condition list. This REPLACES the existing conditions wholesale — to add a second condition to a block, send both the existing one and the new one."}},"required":["conditions"]},"upsellProductRules":{"description":"Rules that decide which products the block recommends. The first matching rule wins. Rules can't carry a discount when sent with an API key.","type":"array","items":{"type":"object","properties":{"priority":{"default":0,"description":"Lower runs first; the first matching rule wins.","type":"integer","minimum":0,"maximum":9007199254740991},"when":{"type":"object","properties":{"match":{"default":"all","description":"`all` = every condition must hold (AND). `any` = at least one (OR).","type":"string","enum":["all","any"]},"conditions":{"minItems":1,"type":"array","items":{"oneOf":[{"type":"object","properties":{"attribute":{"type":"string","const":"anything"}},"required":["attribute"]},{"type":"object","properties":{"attribute":{"type":"string","const":"cartSubtotal"},"operator":{"type":"string","enum":["greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"type":"number","description":"Subtotal to compare against, in the shop's currency (e.g. 50 for $50). For `between`, this is the lower bound."},"valueMax":{"description":"Upper bound. Required for `between`, ignored otherwise.","type":"number"}},"required":["attribute","operator","value"]},{"type":"object","properties":{"attribute":{"type":"string","const":"cartItemCount"},"operator":{"type":"string","enum":["greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Item count to compare against. For `between`, the lower bound."},"valueMax":{"description":"Upper bound. Required for `between`, ignored otherwise.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["attribute","operator","value"]},{"type":"object","properties":{"attribute":{"type":"string","const":"collection"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"collectionIds":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Collection ids the cart must (or must not) contain a product from. Numeric ids or gids from list_collections — the server normalizes them. A title or handle is rejected; look the collection up first."}},"required":["attribute","collectionIds"]},{"type":"object","properties":{"attribute":{"type":"string","const":"tag"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"tags":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Product tags the cart must (or must not) contain."}},"required":["attribute","tags"]},{"type":"object","properties":{"attribute":{"type":"string","const":"subscription"},"operator":{"default":"includes","description":"`includes` = cart has at least one subscription line; `doesNotInclude` = none.","type":"string","enum":["includes","doesNotInclude"]}},"required":["attribute"]},{"type":"object","properties":{"attribute":{"type":"string","const":"productId"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"products":{"minItems":1,"type":"array","items":{"type":"object","properties":{"productId":{"type":"string","description":"Shopify product id. Numeric id or gid — the server normalizes it."},"variantIds":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Variant ids of this product that count as a match. Required: a product entry with no variants can never match a cart. Get them with get_product (one call per product, works on every store) and pass all of them unless the merchant named specific variants; search_products isn't available on every store."}},"required":["productId","variantIds"]}}},"required":["attribute","products"]}],"description":"One cart condition. `anything` matches every cart and cannot be combined with other conditions.","type":"object"},"description":"The full condition list. This REPLACES the existing conditions wholesale — to add a second condition to a block, send both the existing one and the new one."}},"required":["conditions"],"description":"Cart conditions that trigger this rule. Use a single `anything` condition for a rule that always applies."},"recommend":{"oneOf":[{"type":"object","properties":{"source":{"type":"string","const":"shopifyRecommendations"}},"required":["source"]},{"type":"object","properties":{"source":{"type":"string","const":"collection"},"collectionId":{"type":"string","description":"Collection to recommend from. Numeric id or gid from list_collections — the server normalizes it. A title or handle is rejected; look the collection up first. Singular because the renderer resolves only one collection per rule."},"tags":{"description":"Optional: narrow the collection to products carrying ALL of these tags (ANDed) — unlike a tag-source rule, where the tags are ORed.","type":"array","items":{"type":"string"}}},"required":["source","collectionId"]},{"type":"object","properties":{"source":{"type":"string","const":"tag"},"tags":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Recommend products carrying ANY of these tags (they are ORed together)."}},"required":["source","tags"]},{"type":"object","properties":{"source":{"type":"string","const":"products"},"products":{"minItems":1,"type":"array","items":{"type":"object","properties":{"productId":{"type":"string","description":"Numeric id or gid; the server normalizes it."},"variantIds":{"description":"Variants to offer. Omit to offer every variant of the product.","type":"array","items":{"type":"string"}}},"required":["productId"]},"description":"Explicit products, in display order. The server hydrates titles, images and prices from Shopify — do not invent them."}},"required":["source","products"]}],"description":"Where the block's recommended products come from: Shopify's own recommendations for the cart, a collection, a tag search, or an explicit product list.","type":"object"},"discount":{"description":"Not accepted with an API key. Discounts are set in Intelligems, or through the Intelligems MCP while signed in; a PUT keeps the saved discount.","not":{}}},"required":["when","recommend"]}}},"required":["blockType","variationId"],"additionalProperties":false},{"type":"object","properties":{"blockType":{"type":"string","const":"shippingProgressBar","description":"The block type. Picks which `variables`, `styles` and `template` values are accepted. A PUT can't change a block's type."},"variationId":{"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":"The variation the block is added to. It must belong to the experience in the path."},"name":{"description":"Display name for identifying this block in the dashboard.","type":"string"},"template":{"description":"The preset the block's defaults are seeded from. Values depend on `blockType`. Omit it to use the type's default preset.","type":"string","enum":["minimal","milestones"]},"variables":{"description":"Content settings for this block type. Send only the fields you want to set, at any depth; every field you leave out keeps the template's value. A list you send replaces the template's list whole. Unknown fields are rejected. An upsell's `discount` can't be set with an API key: set it in Intelligems.","type":"object","properties":{"headerText":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"]}},"required":["text"]}}]},"currency":{"type":"string"},"template":{"type":"string","enum":["minimal","milestones"]},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"threshold":{"type":"number","exclusiveMinimum":0},"message":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"]}},"required":["text"]}}]},"messageComplete":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"]}},"required":["text"]}}]},"activeIconId":{"type":"string"},"inactiveIconId":{"type":"string"},"breakpointText":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"]}},"required":["text"]}}]}},"required":["threshold","message","messageComplete"]}}},"additionalProperties":false},"styles":{"description":"Style settings for this block type. Send only the groups and fields you want to set, at any depth; everything you leave out keeps the template's value. Unknown groups and fields are rejected.","type":"object","properties":{"typography":{"type":"object","properties":{"header":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"additionalProperties":false},"label":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false},"backgroundColors":{"type":"object","properties":{"header":{"type":"string"},"item":{"type":"string"},"block":{"type":"string"},"milestoneIcon":{"type":"string"}},"additionalProperties":false},"colors":{"type":"object","properties":{"headerText":{"type":"string"},"labelText":{"type":"string"},"barTone":{"type":"string"}},"additionalProperties":false},"layout":{"type":"object","properties":{"headerTextAlign":{"type":"string"},"bodyAlign":{"type":"string"},"itemTextAlign":{"type":"string"},"itemPositionAlign":{"type":"string"},"messageTextAlign":{"type":"string"}},"additionalProperties":false},"appearance":{"type":"object","properties":{"headerBorderThickness":{"type":"string"},"headerBorderStyle":{"type":"string"},"headerCornerRadius":{"type":"string"},"headerPadding":{"type":"string"},"bodySpacing":{"type":"string"},"headingToBodySpacing":{"type":"string"},"blockBorderThickness":{"type":"string"},"blockBorderStyle":{"type":"string"},"blockPadding":{"type":"string"},"blockCornerRadius":{"type":"string"},"milestoneIconCornerRadius":{"type":"string"},"milestoneIconSize":{"type":"string"},"milestoneIconPadding":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false},"displayConditions":{"description":"Cart conditions that decide when the block shows. Omit it to show the block on every cart.","type":"object","properties":{"match":{"default":"all","description":"`all` = every condition must hold (AND). `any` = at least one (OR).","type":"string","enum":["all","any"]},"conditions":{"minItems":1,"type":"array","items":{"oneOf":[{"type":"object","properties":{"attribute":{"type":"string","const":"anything"}},"required":["attribute"]},{"type":"object","properties":{"attribute":{"type":"string","const":"cartSubtotal"},"operator":{"type":"string","enum":["greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"type":"number","description":"Subtotal to compare against, in the shop's currency (e.g. 50 for $50). For `between`, this is the lower bound."},"valueMax":{"description":"Upper bound. Required for `between`, ignored otherwise.","type":"number"}},"required":["attribute","operator","value"]},{"type":"object","properties":{"attribute":{"type":"string","const":"cartItemCount"},"operator":{"type":"string","enum":["greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Item count to compare against. For `between`, the lower bound."},"valueMax":{"description":"Upper bound. Required for `between`, ignored otherwise.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["attribute","operator","value"]},{"type":"object","properties":{"attribute":{"type":"string","const":"collection"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"collectionIds":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Collection ids the cart must (or must not) contain a product from. Numeric ids or gids from list_collections — the server normalizes them. A title or handle is rejected; look the collection up first."}},"required":["attribute","collectionIds"]},{"type":"object","properties":{"attribute":{"type":"string","const":"tag"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"tags":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Product tags the cart must (or must not) contain."}},"required":["attribute","tags"]},{"type":"object","properties":{"attribute":{"type":"string","const":"subscription"},"operator":{"default":"includes","description":"`includes` = cart has at least one subscription line; `doesNotInclude` = none.","type":"string","enum":["includes","doesNotInclude"]}},"required":["attribute"]},{"type":"object","properties":{"attribute":{"type":"string","const":"productId"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"products":{"minItems":1,"type":"array","items":{"type":"object","properties":{"productId":{"type":"string","description":"Shopify product id. Numeric id or gid — the server normalizes it."},"variantIds":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Variant ids of this product that count as a match. Required: a product entry with no variants can never match a cart. Get them with get_product (one call per product, works on every store) and pass all of them unless the merchant named specific variants; search_products isn't available on every store."}},"required":["productId","variantIds"]}}},"required":["attribute","products"]}],"description":"One cart condition. `anything` matches every cart and cannot be combined with other conditions.","type":"object"},"description":"The full condition list. This REPLACES the existing conditions wholesale — to add a second condition to a block, send both the existing one and the new one."}},"required":["conditions"]}},"required":["blockType","variationId"],"additionalProperties":false},{"type":"object","properties":{"blockType":{"type":"string","const":"timer","description":"The block type. Picks which `variables`, `styles` and `template` values are accepted. A PUT can't change a block's type."},"variationId":{"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":"The variation the block is added to. It must belong to the experience in the path."},"name":{"description":"Display name for identifying this block in the dashboard.","type":"string"},"template":{"description":"The preset the block's defaults are seeded from. Values depend on `blockType`. Omit it to use the type's default preset.","type":"string","enum":["textCountdown","digitalClock","inlinePill"]},"variables":{"description":"Content settings for this block type. Send only the fields you want to set, at any depth; every field you leave out keeps the template's value. A list you send replaces the template's list whole. Unknown fields are rejected. An upsell's `discount` can't be set with an API key: set it in Intelligems.","type":"object","properties":{"timerMode":{"type":"string","enum":["fixedDate","perVisitor","recurring"]},"endDateTime":{"type":["string","null"]},"durationMinutes":{"type":"integer","minimum":1,"maximum":9007199254740991},"resetIntervalUnit":{"anyOf":[{"type":"string","enum":["hour","day","week"]},{"type":"null"}]},"resetTimeOfDay":{"anyOf":[{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},{"type":"null"}]},"resetDayOfWeek":{"anyOf":[{"anyOf":[{"type":"number","const":1},{"type":"number","const":2},{"type":"number","const":3},{"type":"number","const":4},{"type":"number","const":5},{"type":"number","const":6},{"type":"number","const":7}]},{"type":"null"}]},"resetMinuteOfHour":{"anyOf":[{"type":"integer","minimum":0,"maximum":59},{"type":"null"}]},"resetTimezone":{"type":["string","null"]},"expiredBehavior":{"type":"string","enum":["remove","showText"]},"timerTemplate":{"type":"string","enum":["textCountdown","digitalClock","inlinePill"]},"showDays":{"type":"boolean"},"showHours":{"type":"boolean"},"showMinutes":{"type":"boolean"},"showSeconds":{"type":"boolean"},"countdownText":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"]}},"required":["text"]}}]},"expiredText":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"]}},"required":["text"]}}]},"headline":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"]}},"required":["text"]}}]}},"additionalProperties":false},"styles":{"description":"Style settings for this block type. Send only the groups and fields you want to set, at any depth; everything you leave out keeps the template's value. Unknown groups and fields are rejected.","type":"object","properties":{"typography":{"type":"object","properties":{"text":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false},"backgroundColors":{"type":"object","properties":{"block":{"type":"string"},"expired":{"type":"string"}},"additionalProperties":false},"colors":{"type":"object","properties":{"text":{"type":"string"},"expiredText":{"type":"string"},"digit":{"type":"string"}},"additionalProperties":false},"layout":{"type":"object","properties":{"textAlign":{"type":"string"}},"additionalProperties":false},"appearance":{"type":"object","properties":{"blockBorderStyle":{"type":"string"},"blockBorderThickness":{"type":"string"},"blockCornerRadius":{"type":"string"},"blockPadding":{"type":"string"}},"additionalProperties":false},"digits":{"type":"object","properties":{"separator":{"type":"string","enum":["colon","dot","units"]},"size":{"type":"string","enum":["small","base"]}},"additionalProperties":false}},"additionalProperties":false},"displayConditions":{"description":"Cart conditions that decide when the block shows. Omit it to show the block on every cart.","type":"object","properties":{"match":{"default":"all","description":"`all` = every condition must hold (AND). `any` = at least one (OR).","type":"string","enum":["all","any"]},"conditions":{"minItems":1,"type":"array","items":{"oneOf":[{"type":"object","properties":{"attribute":{"type":"string","const":"anything"}},"required":["attribute"]},{"type":"object","properties":{"attribute":{"type":"string","const":"cartSubtotal"},"operator":{"type":"string","enum":["greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"type":"number","description":"Subtotal to compare against, in the shop's currency (e.g. 50 for $50). For `between`, this is the lower bound."},"valueMax":{"description":"Upper bound. Required for `between`, ignored otherwise.","type":"number"}},"required":["attribute","operator","value"]},{"type":"object","properties":{"attribute":{"type":"string","const":"cartItemCount"},"operator":{"type":"string","enum":["greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Item count to compare against. For `between`, the lower bound."},"valueMax":{"description":"Upper bound. Required for `between`, ignored otherwise.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["attribute","operator","value"]},{"type":"object","properties":{"attribute":{"type":"string","const":"collection"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"collectionIds":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Collection ids the cart must (or must not) contain a product from. Numeric ids or gids from list_collections — the server normalizes them. A title or handle is rejected; look the collection up first."}},"required":["attribute","collectionIds"]},{"type":"object","properties":{"attribute":{"type":"string","const":"tag"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"tags":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Product tags the cart must (or must not) contain."}},"required":["attribute","tags"]},{"type":"object","properties":{"attribute":{"type":"string","const":"subscription"},"operator":{"default":"includes","description":"`includes` = cart has at least one subscription line; `doesNotInclude` = none.","type":"string","enum":["includes","doesNotInclude"]}},"required":["attribute"]},{"type":"object","properties":{"attribute":{"type":"string","const":"productId"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"products":{"minItems":1,"type":"array","items":{"type":"object","properties":{"productId":{"type":"string","description":"Shopify product id. Numeric id or gid — the server normalizes it."},"variantIds":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Variant ids of this product that count as a match. Required: a product entry with no variants can never match a cart. Get them with get_product (one call per product, works on every store) and pass all of them unless the merchant named specific variants; search_products isn't available on every store."}},"required":["productId","variantIds"]}}},"required":["attribute","products"]}],"description":"One cart condition. `anything` matches every cart and cannot be combined with other conditions.","type":"object"},"description":"The full condition list. This REPLACES the existing conditions wholesale — to add a second condition to a block, send both the existing one and the new one."}},"required":["conditions"]}},"required":["blockType","variationId"],"additionalProperties":false},{"type":"object","properties":{"blockType":{"type":"string","const":"faqs","description":"The block type. Picks which `variables`, `styles` and `template` values are accepted. A PUT can't change a block's type."},"variationId":{"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":"The variation the block is added to. It must belong to the experience in the path."},"name":{"description":"Display name for identifying this block in the dashboard.","type":"string"},"template":{"description":"The preset the block's defaults are seeded from. Values depend on `blockType`. Omit it to use the type's default preset.","type":"string","enum":["faqsAccordion"]},"variables":{"description":"Content settings for this block type. Send only the fields you want to set, at any depth; every field you leave out keeps the template's value. A list you send replaces the template's list whole. Unknown fields are rejected. An upsell's `discount` can't be set with an API key: set it in Intelligems.","type":"object","properties":{"headerText":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"]}},"required":["text"]}}]},"showDivider":{"type":"boolean"},"allowMultipleOpen":{"type":"boolean"},"questions":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"question":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"]}},"required":["text"]}}]},"answer":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"]}},"required":["text"]}}]},"openByDefault":{"default":false,"type":"boolean"}},"required":["id","question","answer"]}}},"additionalProperties":false},"styles":{"description":"Style settings for this block type. Send only the groups and fields you want to set, at any depth; everything you leave out keeps the template's value. Unknown groups and fields are rejected.","type":"object","properties":{"typography":{"type":"object","properties":{"header":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"additionalProperties":false},"question":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"additionalProperties":false},"answer":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false},"backgroundColors":{"type":"object","properties":{"header":{"type":"string"},"item":{"type":"string"},"block":{"type":"string"}},"additionalProperties":false},"colors":{"type":"object","properties":{"headerText":{"type":"string"},"questionText":{"type":"string"},"answerText":{"type":"string"}},"additionalProperties":false},"layout":{"type":"object","properties":{"headerTextAlign":{"type":"string"},"bodyAlign":{"type":"string"},"itemTextAlign":{"type":"string"},"itemPositionAlign":{"type":"string"}},"additionalProperties":false},"appearance":{"type":"object","properties":{"headerBorderThickness":{"type":"string"},"headerBorderStyle":{"type":"string"},"headerCornerRadius":{"type":"string"},"headerPadding":{"type":"string"},"bodySpacing":{"type":"string"},"headingToBodySpacing":{"type":"string"},"blockBorderThickness":{"type":"string"},"blockBorderStyle":{"type":"string"},"blockPadding":{"type":"string"},"blockCornerRadius":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false},"displayConditions":{"description":"Cart conditions that decide when the block shows. Omit it to show the block on every cart.","type":"object","properties":{"match":{"default":"all","description":"`all` = every condition must hold (AND). `any` = at least one (OR).","type":"string","enum":["all","any"]},"conditions":{"minItems":1,"type":"array","items":{"oneOf":[{"type":"object","properties":{"attribute":{"type":"string","const":"anything"}},"required":["attribute"]},{"type":"object","properties":{"attribute":{"type":"string","const":"cartSubtotal"},"operator":{"type":"string","enum":["greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"type":"number","description":"Subtotal to compare against, in the shop's currency (e.g. 50 for $50). For `between`, this is the lower bound."},"valueMax":{"description":"Upper bound. Required for `between`, ignored otherwise.","type":"number"}},"required":["attribute","operator","value"]},{"type":"object","properties":{"attribute":{"type":"string","const":"cartItemCount"},"operator":{"type":"string","enum":["greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Item count to compare against. For `between`, the lower bound."},"valueMax":{"description":"Upper bound. Required for `between`, ignored otherwise.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["attribute","operator","value"]},{"type":"object","properties":{"attribute":{"type":"string","const":"collection"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"collectionIds":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Collection ids the cart must (or must not) contain a product from. Numeric ids or gids from list_collections — the server normalizes them. A title or handle is rejected; look the collection up first."}},"required":["attribute","collectionIds"]},{"type":"object","properties":{"attribute":{"type":"string","const":"tag"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"tags":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Product tags the cart must (or must not) contain."}},"required":["attribute","tags"]},{"type":"object","properties":{"attribute":{"type":"string","const":"subscription"},"operator":{"default":"includes","description":"`includes` = cart has at least one subscription line; `doesNotInclude` = none.","type":"string","enum":["includes","doesNotInclude"]}},"required":["attribute"]},{"type":"object","properties":{"attribute":{"type":"string","const":"productId"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"products":{"minItems":1,"type":"array","items":{"type":"object","properties":{"productId":{"type":"string","description":"Shopify product id. Numeric id or gid — the server normalizes it."},"variantIds":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Variant ids of this product that count as a match. Required: a product entry with no variants can never match a cart. Get them with get_product (one call per product, works on every store) and pass all of them unless the merchant named specific variants; search_products isn't available on every store."}},"required":["productId","variantIds"]}}},"required":["attribute","products"]}],"description":"One cart condition. `anything` matches every cart and cannot be combined with other conditions.","type":"object"},"description":"The full condition list. This REPLACES the existing conditions wholesale — to add a second condition to a block, send both the existing one and the new one."}},"required":["conditions"]}},"required":["blockType","variationId"],"additionalProperties":false},{"type":"object","properties":{"blockType":{"type":"string","const":"postPurchaseUpsell","description":"The block type. Picks which `variables`, `styles` and `template` values are accepted. A PUT can't change a block's type."},"variationId":{"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":"The variation the block is added to. It must belong to the experience in the path."},"name":{"description":"Display name for identifying this block in the dashboard.","type":"string"},"variables":{"description":"Post-purchase upsell settings. Send only the fields you want to set; the rest keep their current or default values. Values must be on the dashboard's lists and within its limits. The offer's discount (`discountType`, `discountValue`) can't be set with an API key: set it in Intelligems. A PUT keeps the saved discount.","type":"object","properties":{"excludeOutOfStock":{"type":"boolean"},"excludeItemsInCart":{"type":"boolean"},"descriptionEnabled":{"type":"boolean"},"quantitySelectorEnabled":{"type":"boolean"},"countdownTimerEnabled":{"type":"boolean"},"discountType":{"description":"Not accepted with an API key. Discounts are set in Intelligems, or through the Intelligems MCP while signed in; a PUT keeps the saved discount.","not":{}},"discountValue":{"description":"Not accepted with an API key. Discounts are set in Intelligems, or through the Intelligems MCP while signed in; a PUT keeps the saved discount.","not":{}},"compareAtPriceDisplay":{"type":"string","enum":["none","compareAtPrice","regularPrice"],"description":"Struck-through price beside the offer price: 'none', 'compareAtPrice' (the product's compare-at price from Shopify), or 'regularPrice' (needs a discount)."},"bannerTitle":{"type":"string","description":"Callout banner title. New offers already show \"It's not too late to add this to your order\"; only send this when the merchant asks to change the banner. May include '#customerFirstName'. The banner hides when both title and subtitle are empty."},"bannerSubtitle":{"type":"string","description":"Callout banner subtitle. New offers already show \"Don't miss out on these picks for you\"; only send this when the merchant asks to change it."},"customerFirstNameFallback":{"type":"string","description":"Shown in place of '#customerFirstName' when the name is unknown. Only send this when the banner uses '#customerFirstName'."},"maxProductLimit":{"type":"integer","minimum":1,"maximum":10,"description":"How many products the offer shows. New offers already show 3; only send this when the merchant asks for a different number. Moving to or from 1 also turns the description on or off, unless `descriptionEnabled` is sent."},"offerTimeout":{"type":"integer","minimum":1,"maximum":60,"description":"Minutes before the offer closes and the shopper goes to the thank-you page. New offers already use 60; only send this when the merchant asks for a different time."},"headingLevel":{"type":"string","enum":["1","2","3","auto"],"description":"Heading level for the product title. Defaults to 'auto'; only send this when the merchant asks."},"imageAspectRatio":{"type":"string","enum":["original","1:1"],"description":"Product image shape. Defaults to '1:1'; only send this when the merchant asks."},"quantityLabel":{"type":"string","description":"Label above the quantity selector. Defaults to \"Quantity\"; only send this when the merchant asks to change it."},"maxQuantityType":{"type":"string","enum":["noMaximum","setMaximum"],"description":"'noMaximum' (the default), or 'setMaximum' to cap the quantity at `maxQuantity`."},"maxQuantity":{"type":"integer","minimum":1,"maximum":99,"description":"Most units a shopper can add, when `maxQuantityType` is 'setMaximum'."},"timerCheckout":{"type":"object","properties":{"countdownText":{"type":"string","description":"Copy shown while the countdown is running. Defaults to \"Offer expires in #countdownTextTimeRemaining\"; only send this when the merchant asks to change the wording. It must contain '#countdownTextTimeRemaining' where the time goes, which is replaced with the live countdown. Never use '{{...}}' placeholders."},"expiredText":{"type":"string","description":"Copy shown once the countdown ends, if `expiredBehavior` is 'showText'. Defaults to \"This offer has expired\"; only send this when the merchant asks to change it."},"durationMinutes":{"type":"integer","minimum":1,"maximum":60,"description":"Countdown length in minutes. A new countdown already gets a length that fits the offer; only send this when the merchant asks for one. Can't be longer than `offerTimeout`; a longer value is shortened to fit."},"expiredBehavior":{"type":"string","enum":["remove","showText"],"description":"What happens at zero: 'remove' hides the countdown, 'showText' (the default) swaps in `expiredText`."}},"additionalProperties":false,"description":"Countdown settings. Send only the fields the merchant asked to change; the rest keep the editor's defaults."},"discount":{"description":"Not accepted with an API key. Discounts are set in Intelligems, or through the Intelligems MCP while signed in; a PUT keeps the saved discount.","not":{}}},"additionalProperties":false},"styles":{"description":"Post-purchase upsell styles. Send only the fields you want to set; the rest keep their current or default values. Values must be on the dashboard's lists.","type":"object","properties":{"backgroundColors":{"type":"object","properties":{"banner":{"type":"string","enum":["secondary","transparent"]},"countdown":{"type":"string","enum":["secondary","transparent"]},"expired":{"type":"string","enum":["secondary","transparent"]}},"additionalProperties":false},"colors":{"type":"object","properties":{"expiredText":{"type":"string","enum":["critical","warning","success","subdued"]}},"additionalProperties":false},"appearance":{"type":"object","properties":{"bannerTextAlign":{"type":"string","enum":["left","center","right"]},"countdownTextAlign":{"type":"string","enum":["left","center","right"]},"bannerBorderStyle":{"type":"string","enum":["none","block"]},"countdownBorderStyle":{"type":"string","enum":["none","block"]},"bannerSpacing":{"type":"string","enum":["none","tight","loose"]},"countdownSpacing":{"type":"string","enum":["none","tight","loose"]},"imageFit":{"type":"string","enum":["cover","contain"]},"imageBorder":{"type":"boolean"},"pricingAppearance":{"type":"string","enum":["default","critical","warning","success"]},"pricingEmphasized":{"type":"boolean"},"descriptionSubdued":{"type":"boolean"},"separatorWidth":{"type":"string","enum":["xtight","tight","loose","xloose"]},"secondaryButtonStyle":{"type":"string","enum":["default","subdued","plain"]}},"additionalProperties":false}},"additionalProperties":false},"upsellProductRules":{"description":"Rules that decide which products the block recommends. The first matching rule wins. Rules can't carry a discount when sent with an API key.","type":"array","items":{"type":"object","properties":{"priority":{"default":0,"description":"Lower runs first; the first matching rule wins.","type":"integer","minimum":0,"maximum":9007199254740991},"when":{"type":"object","properties":{"match":{"default":"all","description":"`all` = every condition must hold (AND). `any` = at least one (OR).","type":"string","enum":["all","any"]},"conditions":{"minItems":1,"type":"array","items":{"oneOf":[{"type":"object","properties":{"attribute":{"type":"string","const":"anything"}},"required":["attribute"]},{"type":"object","properties":{"attribute":{"type":"string","const":"cartSubtotal"},"operator":{"type":"string","enum":["greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"type":"number","description":"Subtotal to compare against, in the shop's currency (e.g. 50 for $50). For `between`, this is the lower bound."},"valueMax":{"description":"Upper bound. Required for `between`, ignored otherwise.","type":"number"}},"required":["attribute","operator","value"]},{"type":"object","properties":{"attribute":{"type":"string","const":"cartItemCount"},"operator":{"type":"string","enum":["greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Item count to compare against. For `between`, the lower bound."},"valueMax":{"description":"Upper bound. Required for `between`, ignored otherwise.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["attribute","operator","value"]},{"type":"object","properties":{"attribute":{"type":"string","const":"collection"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"collectionIds":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Collection ids the cart must (or must not) contain a product from. Numeric ids or gids from list_collections — the server normalizes them. A title or handle is rejected; look the collection up first."}},"required":["attribute","collectionIds"]},{"type":"object","properties":{"attribute":{"type":"string","const":"tag"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"tags":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Product tags the cart must (or must not) contain."}},"required":["attribute","tags"]},{"type":"object","properties":{"attribute":{"type":"string","const":"subscription"},"operator":{"default":"includes","description":"`includes` = cart has at least one subscription line; `doesNotInclude` = none.","type":"string","enum":["includes","doesNotInclude"]}},"required":["attribute"]},{"type":"object","properties":{"attribute":{"type":"string","const":"productId"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"products":{"minItems":1,"type":"array","items":{"type":"object","properties":{"productId":{"type":"string","description":"Shopify product id. Numeric id or gid — the server normalizes it."},"variantIds":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Variant ids of this product that count as a match. Required: a product entry with no variants can never match a cart. Get them with get_product (one call per product, works on every store) and pass all of them unless the merchant named specific variants; search_products isn't available on every store."}},"required":["productId","variantIds"]}}},"required":["attribute","products"]}],"description":"One cart condition. `anything` matches every cart and cannot be combined with other conditions.","type":"object"},"description":"The full condition list. This REPLACES the existing conditions wholesale — to add a second condition to a block, send both the existing one and the new one."}},"required":["conditions"],"description":"Cart conditions that trigger this rule. Use a single `anything` condition for a rule that always applies."},"recommend":{"oneOf":[{"type":"object","properties":{"source":{"type":"string","const":"shopifyRecommendations"}},"required":["source"]},{"type":"object","properties":{"source":{"type":"string","const":"collection"},"collectionId":{"type":"string","description":"Collection to recommend from. Numeric id or gid from list_collections — the server normalizes it. A title or handle is rejected; look the collection up first. Singular because the renderer resolves only one collection per rule."},"tags":{"description":"Optional: narrow the collection to products carrying ALL of these tags (ANDed) — unlike a tag-source rule, where the tags are ORed.","type":"array","items":{"type":"string"}}},"required":["source","collectionId"]},{"type":"object","properties":{"source":{"type":"string","const":"tag"},"tags":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Recommend products carrying ANY of these tags (they are ORed together)."}},"required":["source","tags"]},{"type":"object","properties":{"source":{"type":"string","const":"products"},"products":{"minItems":1,"type":"array","items":{"type":"object","properties":{"productId":{"type":"string","description":"Numeric id or gid; the server normalizes it."},"variantIds":{"description":"Variants to offer. Omit to offer every variant of the product.","type":"array","items":{"type":"string"}}},"required":["productId"]},"description":"Explicit products, in display order. The server hydrates titles, images and prices from Shopify — do not invent them."}},"required":["source","products"]}],"description":"Where the block's recommended products come from: Shopify's own recommendations for the cart, a collection, a tag search, or an explicit product list.","type":"object"},"discount":{"description":"Not accepted with an API key. Discounts are set in Intelligems, or through the Intelligems MCP while signed in; a PUT keeps the saved discount.","not":{}}},"required":["when","recommend"]}}},"required":["blockType","variationId"],"additionalProperties":false}],"type":"object"}}}},"responses":{"200":{"description":"OK","headers":{"access-control-allow-origin":{"schema":{"type":"string"},"description":"CORS allow-origin header."},"access-control-allow-credentials":{"schema":{"type":"string"},"description":"CORS allow-credentials header."},"content-type":{"schema":{"type":"string"},"description":"Response content type."},"Timing-Allow-Origin":{"schema":{"type":"string"},"description":"Allowed origin for Timing headers."},"X-RateLimit-Limit":{"schema":{"type":"string"},"description":"Maximum requests allowed in the current window."},"X-RateLimit-Remaining":{"schema":{"type":"string"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"string"},"description":"Unix timestamp (ms) when the rate limit resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"block":{"oneOf":[{"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)$","description":"Server-generated. Read-only."},"variationId":{"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":"References the parent variation."},"locationId":{"type":"string","description":"Shopify checkout extensibility target location where the block renders."},"blockType":{"type":"string","const":"trustBadge"},"blockTemplate":{"description":"The template preset this block was created from, within its block type. Null on blocks saved before templates were persisted, which callers must treat as unknown rather than assuming a default.","anyOf":[{"type":"string","enum":["badgeList","badgeTiles","callOut","grid","header","images","brandLogo","textOnly"]},{"type":"null"}]},"name":{"type":"string","description":"Display name for identifying this block in the dashboard."},"displayConditions":{"description":"Optional cart-based conditions; the block renders only when the expression evaluates true against the current cart.","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)$"},"expression":{"type":"array","items":{"type":"object","properties":{"query":{"type":"object","properties":{"key":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"type":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"filter":{"type":"string","enum":["includes","doesNotInclude","greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string"},"inclusionType":{"type":"string","enum":["include","exclude"]}},"required":["variantId","inclusionType"],"additionalProperties":false}}}]}},"required":["key","type","filter"],"additionalProperties":false},"operator":{"type":"string","enum":["and","or","start_paren","end_paren"]}},"additionalProperties":false}}},"required":["id","expression"],"additionalProperties":false},"variables":{"type":"object","properties":{"headerText":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]},"items":{"type":"array","items":{"type":"object","properties":{"order":{"type":"number"},"title":{"anyOf":[{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]},{"type":"null"}]},"subtitle":{"anyOf":[{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]},{"type":"null"}]},"type":{"type":"string"},"icon":{"type":["string","null"]},"iconColor":{"type":["string","null"]},"iconSize":{"type":["string","null"]},"imageSize":{"anyOf":[{"type":"number","minimum":1,"maximum":500},{"type":"null"}]},"imageSizeUnit":{"type":"string","enum":["pixels","percentage"]},"imageAspectRatio":{"type":["string","null"]},"image":{"type":["string","null"]},"mediaSpacing":{"type":"string"}},"required":["order","type","imageSize","imageSizeUnit","mediaSpacing"],"additionalProperties":false}}},"required":["headerText","items"],"additionalProperties":false,"description":"Configurable content for the trust badge (e.g., badge images, guarantee text)."},"styles":{"type":"object","properties":{"typography":{"type":"object","properties":{"header":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"itemTitle":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"itemSubtitle":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false}},"required":["header","itemTitle","itemSubtitle"],"additionalProperties":false},"backgroundColors":{"type":"object","properties":{"header":{"type":"string"},"item":{"type":"string"},"block":{"type":"string"}},"required":["header","item","block"],"additionalProperties":false},"colors":{"type":"object","properties":{"headerText":{"type":"string"},"itemTitleText":{"type":"string"},"itemSubtitleText":{"type":"string"}},"required":["headerText","itemTitleText","itemSubtitleText"],"additionalProperties":false},"layout":{"type":"object","properties":{"headerTextAlign":{"type":"string"},"bodyAlign":{"type":"string"},"itemTextAlign":{"type":"string"},"itemPositionAlign":{"type":"string"},"rowCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"columnCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["headerTextAlign","bodyAlign","itemTextAlign","itemPositionAlign","rowCount","columnCount"],"additionalProperties":false},"appearance":{"type":"object","properties":{"headerBorderThickness":{"type":"string"},"headerBorderStyle":{"default":"none","type":"string"},"headerCornerRadius":{"type":"string"},"headerPadding":{"type":"string"},"bodySpacing":{"type":"string"},"headingToBodySpacing":{"type":"string"},"blockBorderThickness":{"type":"string"},"blockBorderStyle":{"default":"none","type":"string"},"blockPadding":{"type":"string"},"blockCornerRadius":{"type":"string"},"itemBorderThickness":{"type":"string"},"itemBorderStyle":{"default":"none","type":"string"},"itemCornerRadius":{"type":"string"},"itemTextSpacing":{"type":"string"}},"required":["headerBorderThickness","headerBorderStyle","headerCornerRadius","headerPadding","bodySpacing","headingToBodySpacing","blockBorderThickness","blockBorderStyle","blockPadding","blockCornerRadius","itemBorderThickness","itemBorderStyle","itemCornerRadius","itemTextSpacing"],"additionalProperties":false}},"required":["typography","backgroundColors","colors","layout","appearance"],"additionalProperties":false,"description":"CSS styling overrides for the trust badge appearance."}},"required":["id","variationId","locationId","blockType","name","variables","styles"],"additionalProperties":false},{"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)$","description":"Server-generated. Read-only."},"variationId":{"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":"References the parent variation."},"locationId":{"type":"string","description":"Shopify checkout extensibility target location where the block renders."},"blockType":{"type":"string","const":"upsell"},"blockTemplate":{"description":"The template preset this block was created from, within its block type. Null on blocks saved before templates were persisted, which callers must treat as unknown rather than assuming a default.","anyOf":[{"type":"string","enum":["productTiles","productList","singleProduct","singleProductCheckbox"]},{"type":"null"}]},"name":{"type":"string","description":"Display name for identifying this block in the dashboard."},"displayConditions":{"description":"Optional cart-based conditions; the block renders only when the expression evaluates true against the current cart.","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)$"},"expression":{"type":"array","items":{"type":"object","properties":{"query":{"type":"object","properties":{"key":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"type":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"filter":{"type":"string","enum":["includes","doesNotInclude","greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string"},"inclusionType":{"type":"string","enum":["include","exclude"]}},"required":["variantId","inclusionType"],"additionalProperties":false}}}]}},"required":["key","type","filter"],"additionalProperties":false},"operator":{"type":"string","enum":["and","or","start_paren","end_paren"]}},"additionalProperties":false}}},"required":["id","expression"],"additionalProperties":false},"variables":{"type":"object","properties":{"headerText":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]},"maxProductLimit":{"default":3,"type":"integer","minimum":1,"maximum":10},"excludeItemsInCart":{"default":false,"type":"boolean"},"excludeOutOfStock":{"default":false,"type":"boolean"},"buttonText":{"type":"string"},"imageSize":{"type":"number","minimum":1,"maximum":500},"imageSizeUnit":{"type":"string","enum":["pixels","percentage"]},"imageAspectRatio":{"type":"string"},"mediaSpacing":{"type":"string"},"discount":{"type":"object","properties":{"discountType":{"default":"none","type":"string","enum":["none","percentage","fixed"]},"discountValue":{"type":["number","null"]},"compareAtPriceDisplay":{"default":"none","type":"string","enum":["none","compareAtPrice","regularPrice"]}},"required":["discountType","compareAtPriceDisplay"],"additionalProperties":false}},"required":["headerText","maxProductLimit","excludeItemsInCart","excludeOutOfStock","buttonText","imageSize","imageSizeUnit","imageAspectRatio","mediaSpacing"],"additionalProperties":false,"description":"Configurable content for the upsell block (e.g., product selection, heading text, CTA label)."},"styles":{"type":"object","properties":{"typography":{"type":"object","properties":{"header":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"productTitle":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"variantTitle":{"default":{"fontSize":"base","fontStyle":"normal"},"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"price":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"button":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false}},"required":["header","productTitle","variantTitle","price","button"],"additionalProperties":false},"backgroundColors":{"type":"object","properties":{"header":{"type":"string"},"item":{"type":"string"},"block":{"type":"string"},"button":{"default":"auto","type":"string"},"productUnit":{"type":"string"}},"required":["header","item","block","button","productUnit"],"additionalProperties":false},"colors":{"type":"object","properties":{"headerText":{"type":"string"},"productText":{"type":"string"},"variantText":{"default":"subdued","type":"string"},"priceText":{"type":"string"},"carouselArrowColor":{"default":"auto","type":"string"},"carouselArrowStyle":{"default":"primary","type":"string"}},"required":["headerText","productText","variantText","priceText","carouselArrowColor","carouselArrowStyle"],"additionalProperties":false},"layout":{"type":"object","properties":{"headerTextAlign":{"type":"string"},"bodyAlign":{"type":"string"},"itemTextAlign":{"type":"string"},"itemPositionAlign":{"type":"string"},"mobile":{"type":"object","properties":{"rowCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"columnCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["rowCount","columnCount"],"additionalProperties":false},"desktop":{"type":"object","properties":{"rowCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"columnCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["rowCount","columnCount"],"additionalProperties":false}},"required":["headerTextAlign","bodyAlign","itemTextAlign","itemPositionAlign","mobile","desktop"],"additionalProperties":false},"appearance":{"type":"object","properties":{"headerBorderThickness":{"type":"string"},"headerBorderStyle":{"default":"none","type":"string"},"headerCornerRadius":{"type":"string"},"headerPadding":{"type":"string"},"bodySpacing":{"type":"string"},"headingToBodySpacing":{"type":"string"},"blockBorderThickness":{"type":"string"},"blockBorderStyle":{"default":"none","type":"string"},"blockPadding":{"type":"string"},"blockCornerRadius":{"type":"string"},"productBorderThickness":{"type":"string"},"productBorderStyle":{"default":"none","type":"string"},"productCornerRadius":{"type":"string"},"productTextSpacing":{"type":"string"}},"required":["headerBorderThickness","headerBorderStyle","headerCornerRadius","headerPadding","bodySpacing","headingToBodySpacing","blockBorderThickness","blockBorderStyle","blockPadding","blockCornerRadius","productBorderThickness","productBorderStyle","productCornerRadius","productTextSpacing"],"additionalProperties":false}},"required":["typography","backgroundColors","colors","layout","appearance"],"additionalProperties":false,"description":"CSS styling overrides for the upsell block appearance."},"upsellProductRules":{"default":[],"description":"Product selection and recommendation rules that determine which products to show in this upsell block.","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)$"},"checkoutBlockId":{"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)$"},"priority":{"type":"integer","minimum":0,"maximum":9007199254740991},"cartTargeting":{"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)$"},"expression":{"type":"array","items":{"type":"object","properties":{"query":{"type":"object","properties":{"key":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"type":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"filter":{"type":"string","enum":["includes","doesNotInclude","greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string"},"inclusionType":{"type":"string","enum":["include","exclude"]}},"required":["variantId","inclusionType"],"additionalProperties":false}}}]}},"required":["key","type","filter"],"additionalProperties":false},"operator":{"type":"string","enum":["and","or","start_paren","end_paren"]}},"additionalProperties":false}}},"required":["id","expression"],"additionalProperties":false},"action":{"$ref":"#/components/schemas/__schema0"},"variationId":{"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)$"}},"required":["id","checkoutBlockId","priority","cartTargeting","action","variationId"],"additionalProperties":false}},"agenticLogicPlacementId":{"description":"Agentic Logic placement this block evaluates through. Absent means the legacy rule engine serves it — clearing the mapping is the per-surface rollback.","anyOf":[{"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":"null"}]},"agenticLogicRuleId":{"description":"WRITE-SIDE intent: the Agentic Logic rule this block should serve. The experience save upserts the placement and the (placement, variation) assignment from it and stamps `agenticLogicPlacementId`, so callers never assemble that pair themselves. Null detaches the block and returns it to the legacy engine. Reads echo the rule currently assigned.","anyOf":[{"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":"null"}]}},"required":["id","variationId","locationId","blockType","name","variables","styles","upsellProductRules"],"additionalProperties":false},{"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)$","description":"Server-generated. Read-only."},"variationId":{"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":"References the parent variation."},"locationId":{"type":"string","description":"Shopify checkout extensibility target location where the block renders."},"blockType":{"type":"string","const":"shippingProgressBar"},"blockTemplate":{"description":"The template preset this block was created from, within its block type. Null on blocks saved before templates were persisted, which callers must treat as unknown rather than assuming a default.","anyOf":[{"type":"string","enum":["minimal","milestones"]},{"type":"null"}]},"name":{"type":"string","description":"Display name for identifying this block in the dashboard."},"displayConditions":{"description":"Optional cart-based conditions; the block renders only when the expression evaluates true against the current cart.","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)$"},"expression":{"type":"array","items":{"type":"object","properties":{"query":{"type":"object","properties":{"key":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"type":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"filter":{"type":"string","enum":["includes","doesNotInclude","greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string"},"inclusionType":{"type":"string","enum":["include","exclude"]}},"required":["variantId","inclusionType"],"additionalProperties":false}}}]}},"required":["key","type","filter"],"additionalProperties":false},"operator":{"type":"string","enum":["and","or","start_paren","end_paren"]}},"additionalProperties":false}}},"required":["id","expression"],"additionalProperties":false},"variables":{"type":"object","properties":{"headerText":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]},"currency":{"type":"string"},"template":{"default":"minimal","type":"string","enum":["minimal","milestones"]},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"threshold":{"type":"number","exclusiveMinimum":0},"message":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]},"messageComplete":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]},"activeIconId":{"type":"string"},"inactiveIconId":{"type":"string"},"breakpointText":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]}},"required":["threshold","message","messageComplete"],"additionalProperties":false}}},"required":["currency","template","tiers"],"additionalProperties":false},"styles":{"type":"object","properties":{"typography":{"type":"object","properties":{"header":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"label":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false}},"required":["header","label"],"additionalProperties":false},"backgroundColors":{"type":"object","properties":{"header":{"type":"string"},"item":{"type":"string"},"block":{"type":"string"},"milestoneIcon":{"default":"subdued","type":"string"}},"required":["header","item","block","milestoneIcon"],"additionalProperties":false},"colors":{"type":"object","properties":{"headerText":{"type":"string"},"labelText":{"type":"string"},"barTone":{"type":"string"}},"required":["headerText","labelText","barTone"],"additionalProperties":false},"layout":{"type":"object","properties":{"headerTextAlign":{"type":"string"},"bodyAlign":{"type":"string"},"itemTextAlign":{"type":"string"},"itemPositionAlign":{"type":"string"},"messageTextAlign":{"default":"center","type":"string"}},"required":["headerTextAlign","bodyAlign","itemTextAlign","itemPositionAlign","messageTextAlign"],"additionalProperties":false},"appearance":{"type":"object","properties":{"headerBorderThickness":{"type":"string"},"headerBorderStyle":{"default":"none","type":"string"},"headerCornerRadius":{"type":"string"},"headerPadding":{"type":"string"},"bodySpacing":{"type":"string"},"headingToBodySpacing":{"type":"string"},"blockBorderThickness":{"type":"string"},"blockBorderStyle":{"default":"none","type":"string"},"blockPadding":{"type":"string"},"blockCornerRadius":{"type":"string"},"milestoneIconCornerRadius":{"default":"fullyRounded","type":"string"},"milestoneIconSize":{"default":"base","type":"string"},"milestoneIconPadding":{"default":"tight","type":"string"}},"required":["headerBorderThickness","headerBorderStyle","headerCornerRadius","headerPadding","bodySpacing","headingToBodySpacing","blockBorderThickness","blockBorderStyle","blockPadding","blockCornerRadius","milestoneIconCornerRadius","milestoneIconSize","milestoneIconPadding"],"additionalProperties":false}},"required":["typography","backgroundColors","colors","layout","appearance"],"additionalProperties":false}},"required":["id","variationId","locationId","blockType","name","variables","styles"],"additionalProperties":false},{"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)$","description":"Server-generated. Read-only."},"variationId":{"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":"References the parent variation."},"locationId":{"type":"string","description":"Shopify checkout extensibility target location where the block renders."},"blockType":{"type":"string","const":"timer"},"blockTemplate":{"description":"The template preset this block was created from, within its block type. Null on blocks saved before templates were persisted, which callers must treat as unknown rather than assuming a default.","anyOf":[{"type":"string","enum":["textCountdown","digitalClock","inlinePill"]},{"type":"null"}]},"name":{"type":"string","description":"Display name for identifying this block in the dashboard."},"displayConditions":{"description":"Optional cart-based conditions; the block renders only when the expression evaluates true against the current cart.","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)$"},"expression":{"type":"array","items":{"type":"object","properties":{"query":{"type":"object","properties":{"key":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"type":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"filter":{"type":"string","enum":["includes","doesNotInclude","greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string"},"inclusionType":{"type":"string","enum":["include","exclude"]}},"required":["variantId","inclusionType"],"additionalProperties":false}}}]}},"required":["key","type","filter"],"additionalProperties":false},"operator":{"type":"string","enum":["and","or","start_paren","end_paren"]}},"additionalProperties":false}}},"required":["id","expression"],"additionalProperties":false},"variables":{"type":"object","properties":{"timerMode":{"default":"fixedDate","type":"string","enum":["fixedDate","perVisitor","recurring"]},"endDateTime":{"type":["string","null"]},"durationMinutes":{"default":15,"type":"integer","minimum":1,"maximum":9007199254740991},"resetIntervalUnit":{"anyOf":[{"type":"string","enum":["hour","day","week"]},{"type":"null"}]},"resetTimeOfDay":{"anyOf":[{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},{"type":"null"}]},"resetDayOfWeek":{"anyOf":[{"anyOf":[{"type":"number","const":1},{"type":"number","const":2},{"type":"number","const":3},{"type":"number","const":4},{"type":"number","const":5},{"type":"number","const":6},{"type":"number","const":7}]},{"type":"null"}]},"resetMinuteOfHour":{"anyOf":[{"type":"integer","minimum":0,"maximum":59},{"type":"null"}]},"resetTimezone":{"type":["string","null"]},"expiredBehavior":{"default":"showText","type":"string","enum":["remove","showText"]},"timerTemplate":{"default":"textCountdown","type":"string","enum":["textCountdown","digitalClock","inlinePill"]},"showDays":{"default":false,"type":"boolean"},"showHours":{"default":true,"type":"boolean"},"showMinutes":{"default":true,"type":"boolean"},"showSeconds":{"default":true,"type":"boolean"},"countdownText":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]},"expiredText":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]},"headline":{"default":"","anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]}},"required":["timerMode","durationMinutes","expiredBehavior","timerTemplate","showDays","showHours","showMinutes","showSeconds","countdownText","expiredText","headline"],"additionalProperties":false},"styles":{"type":"object","properties":{"typography":{"type":"object","properties":{"text":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false}},"required":["text"],"additionalProperties":false},"backgroundColors":{"type":"object","properties":{"block":{"type":"string"},"expired":{"type":"string"}},"required":["block","expired"],"additionalProperties":false},"colors":{"type":"object","properties":{"text":{"type":"string"},"expiredText":{"type":"string"},"digit":{"default":"info","type":"string"}},"required":["text","expiredText","digit"],"additionalProperties":false},"layout":{"type":"object","properties":{"textAlign":{"type":"string"}},"required":["textAlign"],"additionalProperties":false},"appearance":{"type":"object","properties":{"blockBorderStyle":{"default":"none","type":"string"},"blockBorderThickness":{"type":"string"},"blockCornerRadius":{"type":"string"},"blockPadding":{"type":"string"}},"required":["blockBorderStyle","blockBorderThickness","blockCornerRadius","blockPadding"],"additionalProperties":false},"digits":{"default":{"separator":"colon","size":"base"},"type":"object","properties":{"separator":{"default":"colon","type":"string","enum":["colon","dot","units"]},"size":{"default":"base","type":"string","enum":["small","base"]}},"required":["separator","size"],"additionalProperties":false}},"required":["typography","backgroundColors","colors","layout","appearance","digits"],"additionalProperties":false}},"required":["id","variationId","locationId","blockType","name","variables","styles"],"additionalProperties":false},{"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)$","description":"Server-generated. Read-only."},"variationId":{"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":"References the parent variation."},"locationId":{"type":"string","description":"Shopify checkout extensibility target location where the block renders."},"blockType":{"type":"string","const":"faqs"},"blockTemplate":{"description":"The template preset this block was created from, within its block type. Null on blocks saved before templates were persisted, which callers must treat as unknown rather than assuming a default.","anyOf":[{"type":"string","enum":["faqsAccordion"]},{"type":"null"}]},"name":{"type":"string","description":"Display name for identifying this block in the dashboard."},"displayConditions":{"description":"Optional cart-based conditions; the block renders only when the expression evaluates true against the current cart.","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)$"},"expression":{"type":"array","items":{"type":"object","properties":{"query":{"type":"object","properties":{"key":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"type":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"filter":{"type":"string","enum":["includes","doesNotInclude","greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string"},"inclusionType":{"type":"string","enum":["include","exclude"]}},"required":["variantId","inclusionType"],"additionalProperties":false}}}]}},"required":["key","type","filter"],"additionalProperties":false},"operator":{"type":"string","enum":["and","or","start_paren","end_paren"]}},"additionalProperties":false}}},"required":["id","expression"],"additionalProperties":false},"variables":{"type":"object","properties":{"headerText":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]},"showDivider":{"default":true,"type":"boolean"},"allowMultipleOpen":{"default":false,"type":"boolean"},"questions":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"question":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]},"answer":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]},"openByDefault":{"default":false,"type":"boolean"}},"required":["id","question","answer","openByDefault"],"additionalProperties":false}}},"required":["showDivider","allowMultipleOpen","questions"],"additionalProperties":false},"styles":{"type":"object","properties":{"typography":{"type":"object","properties":{"header":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"question":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"answer":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false}},"required":["header","question","answer"],"additionalProperties":false},"backgroundColors":{"type":"object","properties":{"header":{"type":"string"},"item":{"type":"string"},"block":{"type":"string"}},"required":["header","item","block"],"additionalProperties":false},"colors":{"type":"object","properties":{"headerText":{"type":"string"},"questionText":{"type":"string"},"answerText":{"type":"string"}},"required":["headerText","questionText","answerText"],"additionalProperties":false},"layout":{"type":"object","properties":{"headerTextAlign":{"type":"string"},"bodyAlign":{"type":"string"},"itemTextAlign":{"type":"string"},"itemPositionAlign":{"type":"string"}},"required":["headerTextAlign","bodyAlign","itemTextAlign","itemPositionAlign"],"additionalProperties":false},"appearance":{"type":"object","properties":{"headerBorderThickness":{"type":"string"},"headerBorderStyle":{"default":"none","type":"string"},"headerCornerRadius":{"type":"string"},"headerPadding":{"type":"string"},"bodySpacing":{"type":"string"},"headingToBodySpacing":{"type":"string"},"blockBorderThickness":{"type":"string"},"blockBorderStyle":{"default":"none","type":"string"},"blockPadding":{"type":"string"},"blockCornerRadius":{"type":"string"}},"required":["headerBorderThickness","headerBorderStyle","headerCornerRadius","headerPadding","bodySpacing","headingToBodySpacing","blockBorderThickness","blockBorderStyle","blockPadding","blockCornerRadius"],"additionalProperties":false}},"required":["typography","backgroundColors","colors","layout","appearance"],"additionalProperties":false}},"required":["id","variationId","locationId","blockType","name","variables","styles"],"additionalProperties":false},{"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)$","description":"Server-generated. Read-only."},"variationId":{"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":"References the parent variation."},"locationId":{"type":"string","description":"Shopify checkout extensibility target location where the block renders."},"blockType":{"type":"string","const":"postPurchaseUpsell"},"blockTemplate":{"description":"The template preset this block was created from, within its block type. Null on blocks saved before templates were persisted, which callers must treat as unknown rather than assuming a default.","type":"null"},"name":{"type":"string","description":"Display name for identifying this block in the dashboard."},"displayConditions":{"description":"Optional cart-based conditions; the block renders only when the expression evaluates true against the current cart.","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)$"},"expression":{"type":"array","items":{"type":"object","properties":{"query":{"type":"object","properties":{"key":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"type":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"filter":{"type":"string","enum":["includes","doesNotInclude","greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string"},"inclusionType":{"type":"string","enum":["include","exclude"]}},"required":["variantId","inclusionType"],"additionalProperties":false}}}]}},"required":["key","type","filter"],"additionalProperties":false},"operator":{"type":"string","enum":["and","or","start_paren","end_paren"]}},"additionalProperties":false}}},"required":["id","expression"],"additionalProperties":false},"variables":{"type":"object","properties":{"headerText":{"type":"string"},"discountType":{"default":"none","type":"string","enum":["none","percentage","fixed"]},"discountValue":{"type":["number","null"]},"compareAtPriceDisplay":{"default":"none","type":"string","enum":["none","compareAtPrice","regularPrice"]},"imageAspectRatio":{"type":"string"},"excludeOutOfStock":{"type":"boolean"},"excludeItemsInCart":{"type":"boolean"},"maxProductLimit":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"bannerEnabled":{"type":"boolean"},"bannerTitle":{"type":"string"},"bannerSubtitle":{"type":"string"},"customerFirstNameFallback":{"type":"string"},"compareAtPriceEnabled":{"type":"boolean"},"descriptionEnabled":{"type":"boolean"},"quantitySelectorEnabled":{"type":"boolean"},"quantityLabel":{"type":"string"},"maxQuantityType":{"type":"string"},"maxQuantity":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"moneyLineEnabled":{"default":true,"type":"boolean"},"moneyLineSubtotal":{"default":true,"type":"boolean"},"moneyLineShipping":{"default":true,"type":"boolean"},"moneyLineTaxes":{"default":true,"type":"boolean"},"primaryButtonText":{"default":"Accept offer","type":"string"},"secondaryButtonEnabled":{"default":true,"type":"boolean"},"secondaryButtonText":{"default":"Decline this offer","type":"string"},"headingLevel":{"type":"string"},"countdownTimerEnabled":{"type":"boolean"},"timerCheckout":{"type":"object","properties":{"timerMode":{"default":"fixedDate","type":"string","enum":["fixedDate","perVisitor","recurring"]},"endDateTime":{"type":["string","null"]},"durationMinutes":{"default":15,"type":"integer","minimum":1,"maximum":9007199254740991},"resetIntervalUnit":{"anyOf":[{"type":"string","enum":["hour","day","week"]},{"type":"null"}]},"resetTimeOfDay":{"anyOf":[{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},{"type":"null"}]},"resetDayOfWeek":{"anyOf":[{"anyOf":[{"type":"number","const":1},{"type":"number","const":2},{"type":"number","const":3},{"type":"number","const":4},{"type":"number","const":5},{"type":"number","const":6},{"type":"number","const":7}]},{"type":"null"}]},"resetMinuteOfHour":{"anyOf":[{"type":"integer","minimum":0,"maximum":59},{"type":"null"}]},"resetTimezone":{"type":["string","null"]},"expiredBehavior":{"default":"showText","type":"string","enum":["remove","showText"]},"timerTemplate":{"default":"textCountdown","type":"string","enum":["textCountdown","digitalClock","inlinePill"]},"showDays":{"default":false,"type":"boolean"},"showHours":{"default":true,"type":"boolean"},"showMinutes":{"default":true,"type":"boolean"},"showSeconds":{"default":true,"type":"boolean"},"countdownText":{"type":"string"},"expiredText":{"type":"string"},"headline":{"default":"","type":"string"}},"required":["timerMode","durationMinutes","expiredBehavior","timerTemplate","showDays","showHours","showMinutes","showSeconds","countdownText","expiredText","headline"],"additionalProperties":false},"offerTimeout":{"type":"number"},"discount":{"type":"object","properties":{"discountType":{"default":"none","type":"string","enum":["none","percentage","fixed"]},"discountValue":{"type":["number","null"]},"compareAtPriceDisplay":{"default":"none","type":"string","enum":["none","compareAtPrice","regularPrice"]}},"required":["discountType","compareAtPriceDisplay"],"additionalProperties":false}},"required":["headerText","discountType","compareAtPriceDisplay","imageAspectRatio","excludeOutOfStock","excludeItemsInCart","maxProductLimit","bannerEnabled","compareAtPriceEnabled","descriptionEnabled","quantitySelectorEnabled","moneyLineEnabled","moneyLineSubtotal","moneyLineShipping","moneyLineTaxes","primaryButtonText","secondaryButtonEnabled","secondaryButtonText","headingLevel"],"additionalProperties":false},"styles":{"type":"object","properties":{"typography":{"type":"object","properties":{"banner":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"productTitle":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"price":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"description":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"primaryButton":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"secondaryButton":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false}},"required":["productTitle","price","primaryButton"],"additionalProperties":false},"backgroundColors":{"type":"object","properties":{"banner":{"type":"string"},"primaryButton":{"type":"string"},"secondaryButton":{"type":"string"},"countdown":{"type":"string"},"expired":{"type":"string"}},"required":["banner","primaryButton"],"additionalProperties":false},"colors":{"type":"object","properties":{"bannerText":{"type":"string"},"productText":{"type":"string"},"priceText":{"type":"string"},"descriptionText":{"type":"string"},"primaryButtonText":{"type":"string"},"secondaryButtonText":{"type":"string"},"expiredText":{"type":"string"}},"required":["productText","priceText","primaryButtonText"],"additionalProperties":false},"appearance":{"type":"object","properties":{"bannerBorderStyle":{"type":"string"},"bannerSpacing":{"type":"string"},"bannerTextAlign":{"type":"string"},"separatorWidth":{"type":"string"},"imageFit":{"type":"string"},"imageBorder":{"type":"boolean"},"pricingAppearance":{"type":"string"},"pricingEmphasized":{"type":"boolean"},"pricingSubduedStyle":{"type":"boolean"},"descriptionSubdued":{"type":"boolean"},"secondaryButtonStyle":{"type":"string"},"countdownTextAlign":{"type":"string"},"countdownBorderStyle":{"type":"string"},"countdownSpacing":{"type":"string"}},"required":["bannerBorderStyle","bannerSpacing","bannerTextAlign","separatorWidth","imageFit","imageBorder","pricingEmphasized","descriptionSubdued","secondaryButtonStyle"],"additionalProperties":false}},"required":["typography","backgroundColors","colors","appearance"],"additionalProperties":false},"upsellProductRules":{"default":[],"description":"Product selection and recommendation rules that determine which products to show in this upsell block.","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)$"},"checkoutBlockId":{"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)$"},"priority":{"type":"integer","minimum":0,"maximum":9007199254740991},"cartTargeting":{"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)$"},"expression":{"type":"array","items":{"type":"object","properties":{"query":{"type":"object","properties":{"key":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"type":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"filter":{"type":"string","enum":["includes","doesNotInclude","greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string"},"inclusionType":{"type":"string","enum":["include","exclude"]}},"required":["variantId","inclusionType"],"additionalProperties":false}}}]}},"required":["key","type","filter"],"additionalProperties":false},"operator":{"type":"string","enum":["and","or","start_paren","end_paren"]}},"additionalProperties":false}}},"required":["id","expression"],"additionalProperties":false},"action":{"$ref":"#/components/schemas/__schema0"},"variationId":{"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)$"}},"required":["id","checkoutBlockId","priority","cartTargeting","action","variationId"],"additionalProperties":false}},"agenticLogicPlacementId":{"description":"Agentic Logic placement this block evaluates through. Absent means the legacy rule engine serves it — clearing the mapping is the per-surface rollback.","anyOf":[{"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":"null"}]},"agenticLogicRuleId":{"description":"WRITE-SIDE intent: the Agentic Logic rule this block should serve. The experience save upserts the placement and the (placement, variation) assignment from it and stamps `agenticLogicPlacementId`, so callers never assemble that pair themselves. Null detaches the block and returns it to the legacy engine. Reads echo the rule currently assigned.","anyOf":[{"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":"null"}]}},"required":["id","variationId","locationId","blockType","name","variables","styles","upsellProductRules"],"additionalProperties":false}],"description":"The saved checkout block.","type":"object"},"adjustments":{"description":"Changes the API made on its own, such as a post-purchase upsell's follow-up rules, or the products a new upsell or post-purchase upsell starts with when the request sends no rules. Absent when there are none.","type":"array","items":{"type":"string"}}},"required":["block"],"additionalProperties":false}}}},"429":{"description":"Too Many Requests","headers":{"access-control-allow-origin":{"schema":{"type":"string"},"description":"CORS allow-origin header."},"access-control-allow-credentials":{"schema":{"type":"string"},"description":"CORS allow-credentials header."},"content-type":{"schema":{"type":"string"},"description":"Response content type."},"X-RateLimit-Limit":{"schema":{"type":"string"},"description":"Maximum requests allowed in the current window."},"X-RateLimit-Remaining":{"schema":{"type":"string"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"string"},"description":"Unix timestamp (ms) when the rate limit resets."},"Retry-After":{"schema":{"type":"string"},"description":"Seconds to wait before retrying after a rate limit hit."}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"retryAfter":{"type":"number"}},"required":["error","message"]}}}}}}}}}
```

## Replace checkout block

> Replaces a checkout block's content.\
> \
> The block keeps its \`id\`, variation, template, and position. Everything else comes from the request: \`name\`, \`variables\`, and \`styles\` are required, and every field you leave out, at any depth, resets to the template's value rather than keeping its saved value. A list you send, such as a trust badge's \`items\` or an FAQ block's \`questions\`, replaces the template's list whole.\
> \
> To change a few settings, \`GET\` the block and copy its \`name\`, \`variables\`, and \`styles\` into the request with your changes. Don't send the whole block back: the body is strict, so the read-only fields \`GET\` returns (\`id\`, \`variationId\`, \`locationId\`, \`blockTemplate\`) are rejected. \`GET\` also returns \`displayConditions\` and \`upsellProductRules\` in their stored, compiled form, which this endpoint doesn't accept. Leave both out to keep them as they are, or send the condition-list form that \`POST\` takes to replace them. Also remove an upsell's \`variables.discount\` when you copy it: discounts can't be sent with an API key.\
> \
> A \`postPurchaseUpsell\` block is the exception: its \`PUT\` merges the fields you send onto the saved block, and returns \`adjustments\` listing anything the API changed on its own to keep the offer valid.\
> \
> \### Required Fields\
> \
> \- \`blockType\` (string) — Must match the saved block's type. A block's type can't be changed.\
> \- \`name\` (string) — Display name in the dashboard\
> \- \`variables\` (object) — The block's content settings. Fields you leave out reset to the template's values.\
> \- \`styles\` (object) — The block's style settings. Fields you leave out reset to the template's values.\
> \
> \### Optional Fields\
> \
> \- \`displayConditions\` (object or \`null\`) — Omit it to keep the current conditions, send \`null\` to remove them, or send a condition list (the same form as \`POST\`) to replace them. Not accepted for \`postPurchaseUpsell\`.\
> \- \`upsellProductRules\` (array or \`null\`) — Omit it to keep the current rules, send \`null\` to remove them, or send a list of rules (the same form as \`POST\`) to replace them. \`upsell\` and \`postPurchaseUpsell\` only.\
> \
> \### Response\
> \
> \`{ "block": { ... } }\`, with the saved block, plus \`adjustments\` for a \`postPurchaseUpsell\` block.\
> \
> \### Important Notes\
> \
> \- The block must belong to the experience in the path, or the request returns a \`404\`.\
> \- A \`PUT\` never changes a block's discount. The block keeps the discount saved in Intelligems, and a request that sends one (an upsell's \`variables.discount\`, a rule's \`discount\`, or a post-purchase upsell's \`discountType\` or \`discountValue\`) returns a \`400\`.\
> \- If a block has a discount, whether on the block or on its saved rules, a \`PUT\` can't change who gets it. Sending \`upsellProductRules\` or \`displayConditions\` (a list or \`null\`) returns a \`400\`, and so does changing \`maxProductLimit\`, \`excludeItemsInCart\`, or a post-purchase upsell's \`maxQuantityType\` or \`maxQuantity\`. Leave the rules and conditions out to keep them, and send the other fields as \`GET\` returns them. To change any of them, edit the block in Intelligems.\
> \- A timer's \`resetTimezone\` is optional. The API sets it to the store's timezone, replacing any value you send. If the store has no timezone, the API keeps the one you send, and a recurring timer sent without one returns a \`400\`. A zone you send has to be an IANA name, such as \`America/New\_York\`: one that isn't returns a \`400\`.\
> \- Updating a \`postPurchaseUpsell\` block doesn't re-check that the store is ready for post-purchase upsells. Only adding one does.\
> \- Changes to a running experience take effect for shoppers immediately.\
> \
> \*\*Rate Limit:\*\* 50 requests per 30s window, refilling 25 tokens every 30s.

```json
{"openapi":"3.1.0","info":{"title":"Intelligems External API v25-10-beta","version":"v25-10-beta"},"tags":[{"name":"Manage Checkout Blocks","description":"Checkout blocks are the content a `checkoutBlock` or `postPurchase` experience tests. Each block belongs to one variation. The following block types are supported:\n\n- `trustBadge` — Trust badges, guarantees, or brand logos\n- `upsell` — Product recommendations in checkout\n- `shippingProgressBar` — Progress toward free shipping\n- `timer` — A countdown timer\n- `faqs` — Collapsible questions and answers\n- `postPurchaseUpsell` — A one-click offer shown after checkout\n\n`blockType` picks which `variables` (content settings), `styles`, and `template` values a request accepts. Unknown fields are rejected with a `400` that names the field.\n\n**Create vs. replace.** `POST` keeps the template's value for every field you leave out, at any depth, so a minimal body creates a complete block. `PUT` replaces the block's content: `name`, `variables`, and `styles` are required, and every field you leave out, at any depth, resets to the template's value instead of keeping the saved one. The exception is `postPurchaseUpsell`: its `PUT` merges the fields you send onto the saved block. A post-purchase upsell may also adjust related settings on its own to stay valid, and lists what it changed in the response's `adjustments`.\n\n**Post-purchase readiness.** Adding a `postPurchaseUpsell` block checks that the store is ready for post-purchase upsells (plan, Shopify permissions, and settings), and returns a `400` listing what to fix if it isn't. API keys get no exemption from this check. Replacing an existing post-purchase upsell with `PUT` doesn't re-run it.\n\n**Discounts.** Discounts can't be set with an API key. Set an offer's discount in Intelligems, or through the Intelligems MCP while signed in. A request that sends one gets a `400`: that's an upsell's `variables.discount`, a product rule's `discount`, or a post-purchase upsell's `discountType` or `discountValue`. A `PUT` keeps the discount saved on the block, along with the settings that decide who gets it: the block's product rules and display conditions, `maxProductLimit` and `excludeItemsInCart`, and a post-purchase upsell's `maxQuantityType` and `maxQuantity`. Changing any of those on a discounted block returns a `400`. You can still rename a discounted block, change its copy and styles, and change a post-purchase upsell's `compareAtPriceDisplay`, which only changes the struck-through price shown. A block without a discount takes any change.\n\n**Display conditions and upsell rules.** `displayConditions` (when a block shows) and `upsellProductRules` (which products an `upsell` or `postPurchaseUpsell` block recommends) are written as a flat list of conditions joined by `match: \"all\"` or `\"any\"`. On `PUT`, omit a field to keep its current value, send `null` to remove it, or send a value to replace it. `postPurchaseUpsell` blocks don't use display conditions, and only `upsell` and `postPurchaseUpsell` blocks take product rules.\n\n**Reading blocks back.** `GET` returns the blocks as they are stored. Stored display conditions and product rules are in the compiled form the storefront evaluates, not the condition-list form you send, so don't send them back on `PUT`.\n\n**Live tests.** You can add, change, and delete blocks on a running experience. Changes take effect for shoppers immediately.\n\nYour organization's plan must include checkout block tests; otherwise every checkout-block endpoint returns a `403`."}],"servers":[{"url":"https://api.intelligems.io","description":"Production"}],"security":[{"intelligems_access_token":[]}],"components":{"securitySchemes":{"intelligems_access_token":{"type":"apiKey","in":"header","name":"intelligems-access-token","description":"Intelligems external API access token."}},"schemas":{"__schema0":{"type":"object","properties":{"discountType":{"default":"none","type":"string","enum":["none","percentage","fixed"]},"discountValue":{"type":["number","null"]},"compareAtPriceDisplay":{"default":"none","type":"string","enum":["none","compareAtPrice","regularPrice"]},"expression":{"type":"array","items":{"type":"object","properties":{"query":{"type":"object","properties":{"key":{"type":"string","enum":["shopifyRecommendations","productId","collection","tag"]},"type":{"type":"string","enum":["shopifyRecommendations","productId","collection","tag"]},"filter":{"type":"string","enum":["includes","doesNotInclude"]},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"array","items":{"type":"object","properties":{"order":{"type":"number"},"productId":{"type":"string"},"productTitle":{"type":"string"},"handle":{"type":["string","null"]},"productImage":{"type":["string","null"]},"description":{"type":["string","null"]},"options":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"values":{"type":"array","items":{"type":"string"}}},"required":["name","values"],"additionalProperties":false}},"variants":{"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string"},"variantTitle":{"type":"string"},"variantImage":{"type":["string","null"]},"price":{"type":"number"},"compareAtPrice":{"type":["number","null"]},"currencyCode":{"type":"string"},"availableForSale":{"type":"boolean"},"sig":{"type":["string","null"]},"inclusionType":{"type":"string","enum":["include","exclude"]},"variantOptions":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"}},"required":["name","value"],"additionalProperties":false}}},"required":["variantId","variantTitle","price","inclusionType"],"additionalProperties":false}},"defaultVariantId":{"type":["string","null"]}},"required":["order","productId","productTitle","variants"],"additionalProperties":false}}]}},"required":["key","type"],"additionalProperties":false},"operator":{"type":"string","enum":["and","or","start_paren","end_paren"]}},"additionalProperties":false}},"onAccept":{"anyOf":[{"$ref":"#/components/schemas/__schema0"},{"type":"null"}]},"onDecline":{"anyOf":[{"$ref":"#/components/schemas/__schema0"},{"type":"null"}]}},"required":["discountType","compareAtPriceDisplay","expression"],"additionalProperties":false}}},"paths":{"/v25-10-beta/experiences/{experienceId}/checkout-blocks/{blockId}":{"put":{"operationId":"putCheckoutBlock","summary":"Replace checkout block","tags":["Manage Checkout Blocks"],"description":"Replaces a checkout block's content.\n\nThe block keeps its `id`, variation, template, and position. Everything else comes from the request: `name`, `variables`, and `styles` are required, and every field you leave out, at any depth, resets to the template's value rather than keeping its saved value. A list you send, such as a trust badge's `items` or an FAQ block's `questions`, replaces the template's list whole.\n\nTo change a few settings, `GET` the block and copy its `name`, `variables`, and `styles` into the request with your changes. Don't send the whole block back: the body is strict, so the read-only fields `GET` returns (`id`, `variationId`, `locationId`, `blockTemplate`) are rejected. `GET` also returns `displayConditions` and `upsellProductRules` in their stored, compiled form, which this endpoint doesn't accept. Leave both out to keep them as they are, or send the condition-list form that `POST` takes to replace them. Also remove an upsell's `variables.discount` when you copy it: discounts can't be sent with an API key.\n\nA `postPurchaseUpsell` block is the exception: its `PUT` merges the fields you send onto the saved block, and returns `adjustments` listing anything the API changed on its own to keep the offer valid.\n\n### Required Fields\n\n- `blockType` (string) — Must match the saved block's type. A block's type can't be changed.\n- `name` (string) — Display name in the dashboard\n- `variables` (object) — The block's content settings. Fields you leave out reset to the template's values.\n- `styles` (object) — The block's style settings. Fields you leave out reset to the template's values.\n\n### Optional Fields\n\n- `displayConditions` (object or `null`) — Omit it to keep the current conditions, send `null` to remove them, or send a condition list (the same form as `POST`) to replace them. Not accepted for `postPurchaseUpsell`.\n- `upsellProductRules` (array or `null`) — Omit it to keep the current rules, send `null` to remove them, or send a list of rules (the same form as `POST`) to replace them. `upsell` and `postPurchaseUpsell` only.\n\n### Response\n\n`{ \"block\": { ... } }`, with the saved block, plus `adjustments` for a `postPurchaseUpsell` block.\n\n### Important Notes\n\n- The block must belong to the experience in the path, or the request returns a `404`.\n- A `PUT` never changes a block's discount. The block keeps the discount saved in Intelligems, and a request that sends one (an upsell's `variables.discount`, a rule's `discount`, or a post-purchase upsell's `discountType` or `discountValue`) returns a `400`.\n- If a block has a discount, whether on the block or on its saved rules, a `PUT` can't change who gets it. Sending `upsellProductRules` or `displayConditions` (a list or `null`) returns a `400`, and so does changing `maxProductLimit`, `excludeItemsInCart`, or a post-purchase upsell's `maxQuantityType` or `maxQuantity`. Leave the rules and conditions out to keep them, and send the other fields as `GET` returns them. To change any of them, edit the block in Intelligems.\n- A timer's `resetTimezone` is optional. The API sets it to the store's timezone, replacing any value you send. If the store has no timezone, the API keeps the one you send, and a recurring timer sent without one returns a `400`. A zone you send has to be an IANA name, such as `America/New_York`: one that isn't returns a `400`.\n- Updating a `postPurchaseUpsell` block doesn't re-check that the store is ready for post-purchase upsells. Only adding one does.\n- Changes to a running experience take effect for shoppers immediately.\n\n**Rate Limit:** 50 requests per 30s window, refilling 25 tokens every 30s.","parameters":[{"in":"path","name":"experienceId","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)$","description":"The experience the checkout block belongs to."},"required":true,"description":"The experience the checkout block belongs to."},{"in":"path","name":"blockId","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)$","description":"The checkout block to act on. Copy it from the GET response."},"required":true,"description":"The checkout block to act on. Copy it from the GET response."}],"requestBody":{"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"blockType":{"type":"string","const":"trustBadge","description":"The block type. Picks which `variables`, `styles` and `template` values are accepted. A PUT can't change a block's type."},"name":{"type":"string","description":"Display name for identifying this block in the dashboard."},"variables":{"type":"object","properties":{"headerText":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"]}},"required":["text"]}}]},"items":{"type":"array","items":{"type":"object","properties":{"order":{"type":"number"},"title":{"anyOf":[{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"]}},"required":["text"]}}]},{"type":"null"}]},"subtitle":{"anyOf":[{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"]}},"required":["text"]}}]},{"type":"null"}]},"type":{"type":"string"},"icon":{"type":["string","null"]},"iconColor":{"type":["string","null"]},"iconSize":{"type":["string","null"]},"imageSize":{"anyOf":[{"type":"number","minimum":1,"maximum":500},{"type":"null"}]},"imageSizeUnit":{"type":"string","enum":["pixels","percentage"]},"imageAspectRatio":{"type":["string","null"]},"image":{"type":["string","null"]},"mediaSpacing":{"type":"string"}},"required":["order","type","imageSize","imageSizeUnit","mediaSpacing"]}}},"additionalProperties":false,"description":"The block's content settings, in the shape GET returns them. Replaces the stored settings: every field you leave out, at any depth, resets to the template's value. A list you send replaces the template's list whole. Unknown fields are rejected. A timer's `resetTimezone` is optional and set to the store's timezone. A store with no timezone keeps the one you send, which has to be an IANA name such as `America/New_York`. An upsell's `discount` can't be sent: the block keeps the discount saved in Intelligems."},"styles":{"type":"object","properties":{"typography":{"type":"object","properties":{"header":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"additionalProperties":false},"itemTitle":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"additionalProperties":false},"itemSubtitle":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false},"backgroundColors":{"type":"object","properties":{"header":{"type":"string"},"item":{"type":"string"},"block":{"type":"string"}},"additionalProperties":false},"colors":{"type":"object","properties":{"headerText":{"type":"string"},"itemTitleText":{"type":"string"},"itemSubtitleText":{"type":"string"}},"additionalProperties":false},"layout":{"type":"object","properties":{"headerTextAlign":{"type":"string"},"bodyAlign":{"type":"string"},"itemTextAlign":{"type":"string"},"itemPositionAlign":{"type":"string"},"rowCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"columnCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"additionalProperties":false},"appearance":{"type":"object","properties":{"headerBorderThickness":{"type":"string"},"headerBorderStyle":{"type":"string"},"headerCornerRadius":{"type":"string"},"headerPadding":{"type":"string"},"bodySpacing":{"type":"string"},"headingToBodySpacing":{"type":"string"},"blockBorderThickness":{"type":"string"},"blockBorderStyle":{"type":"string"},"blockPadding":{"type":"string"},"blockCornerRadius":{"type":"string"},"itemBorderThickness":{"type":"string"},"itemBorderStyle":{"type":"string"},"itemCornerRadius":{"type":"string"},"itemTextSpacing":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false,"description":"The block's style settings, in the shape GET returns them. Replaces the stored styles: every group and field you leave out resets to the template's value. Unknown groups and fields are rejected."},"displayConditions":{"description":"Cart conditions that decide when the block shows, as a condition list. Omit it to keep the current conditions, send null to remove them, or send a condition list to replace them. Don't send back the compiled `displayConditions` from GET; it is a different shape and is rejected. A block with a discount set in Intelligems keeps its conditions: sending them with an API key returns a 400.","anyOf":[{"type":"object","properties":{"match":{"default":"all","description":"`all` = every condition must hold (AND). `any` = at least one (OR).","type":"string","enum":["all","any"]},"conditions":{"minItems":1,"type":"array","items":{"oneOf":[{"type":"object","properties":{"attribute":{"type":"string","const":"anything"}},"required":["attribute"]},{"type":"object","properties":{"attribute":{"type":"string","const":"cartSubtotal"},"operator":{"type":"string","enum":["greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"type":"number","description":"Subtotal to compare against, in the shop's currency (e.g. 50 for $50). For `between`, this is the lower bound."},"valueMax":{"description":"Upper bound. Required for `between`, ignored otherwise.","type":"number"}},"required":["attribute","operator","value"]},{"type":"object","properties":{"attribute":{"type":"string","const":"cartItemCount"},"operator":{"type":"string","enum":["greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Item count to compare against. For `between`, the lower bound."},"valueMax":{"description":"Upper bound. Required for `between`, ignored otherwise.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["attribute","operator","value"]},{"type":"object","properties":{"attribute":{"type":"string","const":"collection"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"collectionIds":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Collection ids the cart must (or must not) contain a product from. Numeric ids or gids from list_collections — the server normalizes them. A title or handle is rejected; look the collection up first."}},"required":["attribute","collectionIds"]},{"type":"object","properties":{"attribute":{"type":"string","const":"tag"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"tags":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Product tags the cart must (or must not) contain."}},"required":["attribute","tags"]},{"type":"object","properties":{"attribute":{"type":"string","const":"subscription"},"operator":{"default":"includes","description":"`includes` = cart has at least one subscription line; `doesNotInclude` = none.","type":"string","enum":["includes","doesNotInclude"]}},"required":["attribute"]},{"type":"object","properties":{"attribute":{"type":"string","const":"productId"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"products":{"minItems":1,"type":"array","items":{"type":"object","properties":{"productId":{"type":"string","description":"Shopify product id. Numeric id or gid — the server normalizes it."},"variantIds":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Variant ids of this product that count as a match. Required: a product entry with no variants can never match a cart. Get them with get_product (one call per product, works on every store) and pass all of them unless the merchant named specific variants; search_products isn't available on every store."}},"required":["productId","variantIds"]}}},"required":["attribute","products"]}],"description":"One cart condition. `anything` matches every cart and cannot be combined with other conditions.","type":"object"},"description":"The full condition list. This REPLACES the existing conditions wholesale — to add a second condition to a block, send both the existing one and the new one."}},"required":["conditions"],"description":"A cart-targeting expression: a flat list of conditions joined by all/any. The server compiles it to the stored postfix form."},{"type":"null"}]}},"required":["blockType","name","variables","styles"],"additionalProperties":false},{"type":"object","properties":{"blockType":{"type":"string","const":"upsell","description":"The block type. Picks which `variables`, `styles` and `template` values are accepted. A PUT can't change a block's type."},"name":{"type":"string","description":"Display name for identifying this block in the dashboard."},"variables":{"type":"object","properties":{"headerText":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"]}},"required":["text"]}}]},"maxProductLimit":{"type":"integer","minimum":1,"maximum":10},"excludeItemsInCart":{"type":"boolean"},"excludeOutOfStock":{"type":"boolean"},"buttonText":{"type":"string"},"imageSize":{"type":"number","minimum":1,"maximum":500},"imageSizeUnit":{"type":"string","enum":["pixels","percentage"]},"imageAspectRatio":{"type":"string"},"mediaSpacing":{"type":"string"},"discount":{"description":"Not accepted with an API key. Discounts are set in Intelligems, or through the Intelligems MCP while signed in; a PUT keeps the saved discount.","not":{}}},"additionalProperties":false,"description":"The block's content settings, in the shape GET returns them. Replaces the stored settings: every field you leave out, at any depth, resets to the template's value. A list you send replaces the template's list whole. Unknown fields are rejected. A timer's `resetTimezone` is optional and set to the store's timezone. A store with no timezone keeps the one you send, which has to be an IANA name such as `America/New_York`. An upsell's `discount` can't be sent: the block keeps the discount saved in Intelligems."},"styles":{"type":"object","properties":{"typography":{"type":"object","properties":{"header":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"additionalProperties":false},"productTitle":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"additionalProperties":false},"variantTitle":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"additionalProperties":false},"price":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"additionalProperties":false},"button":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false},"backgroundColors":{"type":"object","properties":{"header":{"type":"string"},"item":{"type":"string"},"block":{"type":"string"},"button":{"type":"string"},"productUnit":{"type":"string"}},"additionalProperties":false},"colors":{"type":"object","properties":{"headerText":{"type":"string"},"productText":{"type":"string"},"variantText":{"type":"string"},"priceText":{"type":"string"},"carouselArrowColor":{"type":"string"},"carouselArrowStyle":{"type":"string"}},"additionalProperties":false},"layout":{"type":"object","properties":{"headerTextAlign":{"type":"string"},"bodyAlign":{"type":"string"},"itemTextAlign":{"type":"string"},"itemPositionAlign":{"type":"string"},"mobile":{"type":"object","properties":{"rowCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"columnCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"additionalProperties":false},"desktop":{"type":"object","properties":{"rowCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"columnCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"additionalProperties":false}},"additionalProperties":false},"appearance":{"type":"object","properties":{"headerBorderThickness":{"type":"string"},"headerBorderStyle":{"type":"string"},"headerCornerRadius":{"type":"string"},"headerPadding":{"type":"string"},"bodySpacing":{"type":"string"},"headingToBodySpacing":{"type":"string"},"blockBorderThickness":{"type":"string"},"blockBorderStyle":{"type":"string"},"blockPadding":{"type":"string"},"blockCornerRadius":{"type":"string"},"productBorderThickness":{"type":"string"},"productBorderStyle":{"type":"string"},"productCornerRadius":{"type":"string"},"productTextSpacing":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false,"description":"The block's style settings, in the shape GET returns them. Replaces the stored styles: every group and field you leave out resets to the template's value. Unknown groups and fields are rejected."},"displayConditions":{"description":"Cart conditions that decide when the block shows, as a condition list. Omit it to keep the current conditions, send null to remove them, or send a condition list to replace them. Don't send back the compiled `displayConditions` from GET; it is a different shape and is rejected. A block with a discount set in Intelligems keeps its conditions: sending them with an API key returns a 400.","anyOf":[{"type":"object","properties":{"match":{"default":"all","description":"`all` = every condition must hold (AND). `any` = at least one (OR).","type":"string","enum":["all","any"]},"conditions":{"minItems":1,"type":"array","items":{"oneOf":[{"type":"object","properties":{"attribute":{"type":"string","const":"anything"}},"required":["attribute"]},{"type":"object","properties":{"attribute":{"type":"string","const":"cartSubtotal"},"operator":{"type":"string","enum":["greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"type":"number","description":"Subtotal to compare against, in the shop's currency (e.g. 50 for $50). For `between`, this is the lower bound."},"valueMax":{"description":"Upper bound. Required for `between`, ignored otherwise.","type":"number"}},"required":["attribute","operator","value"]},{"type":"object","properties":{"attribute":{"type":"string","const":"cartItemCount"},"operator":{"type":"string","enum":["greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Item count to compare against. For `between`, the lower bound."},"valueMax":{"description":"Upper bound. Required for `between`, ignored otherwise.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["attribute","operator","value"]},{"type":"object","properties":{"attribute":{"type":"string","const":"collection"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"collectionIds":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Collection ids the cart must (or must not) contain a product from. Numeric ids or gids from list_collections — the server normalizes them. A title or handle is rejected; look the collection up first."}},"required":["attribute","collectionIds"]},{"type":"object","properties":{"attribute":{"type":"string","const":"tag"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"tags":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Product tags the cart must (or must not) contain."}},"required":["attribute","tags"]},{"type":"object","properties":{"attribute":{"type":"string","const":"subscription"},"operator":{"default":"includes","description":"`includes` = cart has at least one subscription line; `doesNotInclude` = none.","type":"string","enum":["includes","doesNotInclude"]}},"required":["attribute"]},{"type":"object","properties":{"attribute":{"type":"string","const":"productId"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"products":{"minItems":1,"type":"array","items":{"type":"object","properties":{"productId":{"type":"string","description":"Shopify product id. Numeric id or gid — the server normalizes it."},"variantIds":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Variant ids of this product that count as a match. Required: a product entry with no variants can never match a cart. Get them with get_product (one call per product, works on every store) and pass all of them unless the merchant named specific variants; search_products isn't available on every store."}},"required":["productId","variantIds"]}}},"required":["attribute","products"]}],"description":"One cart condition. `anything` matches every cart and cannot be combined with other conditions.","type":"object"},"description":"The full condition list. This REPLACES the existing conditions wholesale — to add a second condition to a block, send both the existing one and the new one."}},"required":["conditions"],"description":"A cart-targeting expression: a flat list of conditions joined by all/any. The server compiles it to the stored postfix form."},{"type":"null"}]},"upsellProductRules":{"description":"Rules that decide which products the block recommends, in the same form as POST. Omit it to keep the current rules, send null to remove them, or send a list to replace them. Don't send back the stored `upsellProductRules` from GET; it is a different shape and is rejected. Rules can't carry a discount, and a block with a discount set in Intelligems, on the block or on its saved rules, can't have its rules replaced or removed with an API key: edit those in Intelligems.","anyOf":[{"type":"array","items":{"type":"object","properties":{"priority":{"default":0,"description":"Lower runs first; the first matching rule wins.","type":"integer","minimum":0,"maximum":9007199254740991},"when":{"type":"object","properties":{"match":{"default":"all","description":"`all` = every condition must hold (AND). `any` = at least one (OR).","type":"string","enum":["all","any"]},"conditions":{"minItems":1,"type":"array","items":{"oneOf":[{"type":"object","properties":{"attribute":{"type":"string","const":"anything"}},"required":["attribute"]},{"type":"object","properties":{"attribute":{"type":"string","const":"cartSubtotal"},"operator":{"type":"string","enum":["greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"type":"number","description":"Subtotal to compare against, in the shop's currency (e.g. 50 for $50). For `between`, this is the lower bound."},"valueMax":{"description":"Upper bound. Required for `between`, ignored otherwise.","type":"number"}},"required":["attribute","operator","value"]},{"type":"object","properties":{"attribute":{"type":"string","const":"cartItemCount"},"operator":{"type":"string","enum":["greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Item count to compare against. For `between`, the lower bound."},"valueMax":{"description":"Upper bound. Required for `between`, ignored otherwise.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["attribute","operator","value"]},{"type":"object","properties":{"attribute":{"type":"string","const":"collection"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"collectionIds":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Collection ids the cart must (or must not) contain a product from. Numeric ids or gids from list_collections — the server normalizes them. A title or handle is rejected; look the collection up first."}},"required":["attribute","collectionIds"]},{"type":"object","properties":{"attribute":{"type":"string","const":"tag"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"tags":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Product tags the cart must (or must not) contain."}},"required":["attribute","tags"]},{"type":"object","properties":{"attribute":{"type":"string","const":"subscription"},"operator":{"default":"includes","description":"`includes` = cart has at least one subscription line; `doesNotInclude` = none.","type":"string","enum":["includes","doesNotInclude"]}},"required":["attribute"]},{"type":"object","properties":{"attribute":{"type":"string","const":"productId"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"products":{"minItems":1,"type":"array","items":{"type":"object","properties":{"productId":{"type":"string","description":"Shopify product id. Numeric id or gid — the server normalizes it."},"variantIds":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Variant ids of this product that count as a match. Required: a product entry with no variants can never match a cart. Get them with get_product (one call per product, works on every store) and pass all of them unless the merchant named specific variants; search_products isn't available on every store."}},"required":["productId","variantIds"]}}},"required":["attribute","products"]}],"description":"One cart condition. `anything` matches every cart and cannot be combined with other conditions.","type":"object"},"description":"The full condition list. This REPLACES the existing conditions wholesale — to add a second condition to a block, send both the existing one and the new one."}},"required":["conditions"],"description":"Cart conditions that trigger this rule. Use a single `anything` condition for a rule that always applies."},"recommend":{"oneOf":[{"type":"object","properties":{"source":{"type":"string","const":"shopifyRecommendations"}},"required":["source"]},{"type":"object","properties":{"source":{"type":"string","const":"collection"},"collectionId":{"type":"string","description":"Collection to recommend from. Numeric id or gid from list_collections — the server normalizes it. A title or handle is rejected; look the collection up first. Singular because the renderer resolves only one collection per rule."},"tags":{"description":"Optional: narrow the collection to products carrying ALL of these tags (ANDed) — unlike a tag-source rule, where the tags are ORed.","type":"array","items":{"type":"string"}}},"required":["source","collectionId"]},{"type":"object","properties":{"source":{"type":"string","const":"tag"},"tags":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Recommend products carrying ANY of these tags (they are ORed together)."}},"required":["source","tags"]},{"type":"object","properties":{"source":{"type":"string","const":"products"},"products":{"minItems":1,"type":"array","items":{"type":"object","properties":{"productId":{"type":"string","description":"Numeric id or gid; the server normalizes it."},"variantIds":{"description":"Variants to offer. Omit to offer every variant of the product.","type":"array","items":{"type":"string"}}},"required":["productId"]},"description":"Explicit products, in display order. The server hydrates titles, images and prices from Shopify — do not invent them."}},"required":["source","products"]}],"description":"Where the block's recommended products come from: Shopify's own recommendations for the cart, a collection, a tag search, or an explicit product list.","type":"object"},"discount":{"description":"Not accepted with an API key. Discounts are set in Intelligems, or through the Intelligems MCP while signed in; a PUT keeps the saved discount.","not":{}}},"required":["when","recommend"]}},{"type":"null"}]}},"required":["blockType","name","variables","styles"],"additionalProperties":false},{"type":"object","properties":{"blockType":{"type":"string","const":"shippingProgressBar","description":"The block type. Picks which `variables`, `styles` and `template` values are accepted. A PUT can't change a block's type."},"name":{"type":"string","description":"Display name for identifying this block in the dashboard."},"variables":{"type":"object","properties":{"headerText":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"]}},"required":["text"]}}]},"currency":{"type":"string"},"template":{"type":"string","enum":["minimal","milestones"]},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"threshold":{"type":"number","exclusiveMinimum":0},"message":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"]}},"required":["text"]}}]},"messageComplete":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"]}},"required":["text"]}}]},"activeIconId":{"type":"string"},"inactiveIconId":{"type":"string"},"breakpointText":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"]}},"required":["text"]}}]}},"required":["threshold","message","messageComplete"]}}},"additionalProperties":false,"description":"The block's content settings, in the shape GET returns them. Replaces the stored settings: every field you leave out, at any depth, resets to the template's value. A list you send replaces the template's list whole. Unknown fields are rejected. A timer's `resetTimezone` is optional and set to the store's timezone. A store with no timezone keeps the one you send, which has to be an IANA name such as `America/New_York`. An upsell's `discount` can't be sent: the block keeps the discount saved in Intelligems."},"styles":{"type":"object","properties":{"typography":{"type":"object","properties":{"header":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"additionalProperties":false},"label":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false},"backgroundColors":{"type":"object","properties":{"header":{"type":"string"},"item":{"type":"string"},"block":{"type":"string"},"milestoneIcon":{"type":"string"}},"additionalProperties":false},"colors":{"type":"object","properties":{"headerText":{"type":"string"},"labelText":{"type":"string"},"barTone":{"type":"string"}},"additionalProperties":false},"layout":{"type":"object","properties":{"headerTextAlign":{"type":"string"},"bodyAlign":{"type":"string"},"itemTextAlign":{"type":"string"},"itemPositionAlign":{"type":"string"},"messageTextAlign":{"type":"string"}},"additionalProperties":false},"appearance":{"type":"object","properties":{"headerBorderThickness":{"type":"string"},"headerBorderStyle":{"type":"string"},"headerCornerRadius":{"type":"string"},"headerPadding":{"type":"string"},"bodySpacing":{"type":"string"},"headingToBodySpacing":{"type":"string"},"blockBorderThickness":{"type":"string"},"blockBorderStyle":{"type":"string"},"blockPadding":{"type":"string"},"blockCornerRadius":{"type":"string"},"milestoneIconCornerRadius":{"type":"string"},"milestoneIconSize":{"type":"string"},"milestoneIconPadding":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false,"description":"The block's style settings, in the shape GET returns them. Replaces the stored styles: every group and field you leave out resets to the template's value. Unknown groups and fields are rejected."},"displayConditions":{"description":"Cart conditions that decide when the block shows, as a condition list. Omit it to keep the current conditions, send null to remove them, or send a condition list to replace them. Don't send back the compiled `displayConditions` from GET; it is a different shape and is rejected. A block with a discount set in Intelligems keeps its conditions: sending them with an API key returns a 400.","anyOf":[{"type":"object","properties":{"match":{"default":"all","description":"`all` = every condition must hold (AND). `any` = at least one (OR).","type":"string","enum":["all","any"]},"conditions":{"minItems":1,"type":"array","items":{"oneOf":[{"type":"object","properties":{"attribute":{"type":"string","const":"anything"}},"required":["attribute"]},{"type":"object","properties":{"attribute":{"type":"string","const":"cartSubtotal"},"operator":{"type":"string","enum":["greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"type":"number","description":"Subtotal to compare against, in the shop's currency (e.g. 50 for $50). For `between`, this is the lower bound."},"valueMax":{"description":"Upper bound. Required for `between`, ignored otherwise.","type":"number"}},"required":["attribute","operator","value"]},{"type":"object","properties":{"attribute":{"type":"string","const":"cartItemCount"},"operator":{"type":"string","enum":["greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Item count to compare against. For `between`, the lower bound."},"valueMax":{"description":"Upper bound. Required for `between`, ignored otherwise.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["attribute","operator","value"]},{"type":"object","properties":{"attribute":{"type":"string","const":"collection"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"collectionIds":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Collection ids the cart must (or must not) contain a product from. Numeric ids or gids from list_collections — the server normalizes them. A title or handle is rejected; look the collection up first."}},"required":["attribute","collectionIds"]},{"type":"object","properties":{"attribute":{"type":"string","const":"tag"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"tags":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Product tags the cart must (or must not) contain."}},"required":["attribute","tags"]},{"type":"object","properties":{"attribute":{"type":"string","const":"subscription"},"operator":{"default":"includes","description":"`includes` = cart has at least one subscription line; `doesNotInclude` = none.","type":"string","enum":["includes","doesNotInclude"]}},"required":["attribute"]},{"type":"object","properties":{"attribute":{"type":"string","const":"productId"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"products":{"minItems":1,"type":"array","items":{"type":"object","properties":{"productId":{"type":"string","description":"Shopify product id. Numeric id or gid — the server normalizes it."},"variantIds":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Variant ids of this product that count as a match. Required: a product entry with no variants can never match a cart. Get them with get_product (one call per product, works on every store) and pass all of them unless the merchant named specific variants; search_products isn't available on every store."}},"required":["productId","variantIds"]}}},"required":["attribute","products"]}],"description":"One cart condition. `anything` matches every cart and cannot be combined with other conditions.","type":"object"},"description":"The full condition list. This REPLACES the existing conditions wholesale — to add a second condition to a block, send both the existing one and the new one."}},"required":["conditions"],"description":"A cart-targeting expression: a flat list of conditions joined by all/any. The server compiles it to the stored postfix form."},{"type":"null"}]}},"required":["blockType","name","variables","styles"],"additionalProperties":false},{"type":"object","properties":{"blockType":{"type":"string","const":"timer","description":"The block type. Picks which `variables`, `styles` and `template` values are accepted. A PUT can't change a block's type."},"name":{"type":"string","description":"Display name for identifying this block in the dashboard."},"variables":{"type":"object","properties":{"timerMode":{"type":"string","enum":["fixedDate","perVisitor","recurring"]},"endDateTime":{"type":["string","null"]},"durationMinutes":{"type":"integer","minimum":1,"maximum":9007199254740991},"resetIntervalUnit":{"anyOf":[{"type":"string","enum":["hour","day","week"]},{"type":"null"}]},"resetTimeOfDay":{"anyOf":[{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},{"type":"null"}]},"resetDayOfWeek":{"anyOf":[{"anyOf":[{"type":"number","const":1},{"type":"number","const":2},{"type":"number","const":3},{"type":"number","const":4},{"type":"number","const":5},{"type":"number","const":6},{"type":"number","const":7}]},{"type":"null"}]},"resetMinuteOfHour":{"anyOf":[{"type":"integer","minimum":0,"maximum":59},{"type":"null"}]},"resetTimezone":{"type":["string","null"]},"expiredBehavior":{"type":"string","enum":["remove","showText"]},"timerTemplate":{"type":"string","enum":["textCountdown","digitalClock","inlinePill"]},"showDays":{"type":"boolean"},"showHours":{"type":"boolean"},"showMinutes":{"type":"boolean"},"showSeconds":{"type":"boolean"},"countdownText":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"]}},"required":["text"]}}]},"expiredText":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"]}},"required":["text"]}}]},"headline":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"]}},"required":["text"]}}]}},"additionalProperties":false,"description":"The block's content settings, in the shape GET returns them. Replaces the stored settings: every field you leave out, at any depth, resets to the template's value. A list you send replaces the template's list whole. Unknown fields are rejected. A timer's `resetTimezone` is optional and set to the store's timezone. A store with no timezone keeps the one you send, which has to be an IANA name such as `America/New_York`. An upsell's `discount` can't be sent: the block keeps the discount saved in Intelligems."},"styles":{"type":"object","properties":{"typography":{"type":"object","properties":{"text":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false},"backgroundColors":{"type":"object","properties":{"block":{"type":"string"},"expired":{"type":"string"}},"additionalProperties":false},"colors":{"type":"object","properties":{"text":{"type":"string"},"expiredText":{"type":"string"},"digit":{"type":"string"}},"additionalProperties":false},"layout":{"type":"object","properties":{"textAlign":{"type":"string"}},"additionalProperties":false},"appearance":{"type":"object","properties":{"blockBorderStyle":{"type":"string"},"blockBorderThickness":{"type":"string"},"blockCornerRadius":{"type":"string"},"blockPadding":{"type":"string"}},"additionalProperties":false},"digits":{"type":"object","properties":{"separator":{"type":"string","enum":["colon","dot","units"]},"size":{"type":"string","enum":["small","base"]}},"additionalProperties":false}},"additionalProperties":false,"description":"The block's style settings, in the shape GET returns them. Replaces the stored styles: every group and field you leave out resets to the template's value. Unknown groups and fields are rejected."},"displayConditions":{"description":"Cart conditions that decide when the block shows, as a condition list. Omit it to keep the current conditions, send null to remove them, or send a condition list to replace them. Don't send back the compiled `displayConditions` from GET; it is a different shape and is rejected. A block with a discount set in Intelligems keeps its conditions: sending them with an API key returns a 400.","anyOf":[{"type":"object","properties":{"match":{"default":"all","description":"`all` = every condition must hold (AND). `any` = at least one (OR).","type":"string","enum":["all","any"]},"conditions":{"minItems":1,"type":"array","items":{"oneOf":[{"type":"object","properties":{"attribute":{"type":"string","const":"anything"}},"required":["attribute"]},{"type":"object","properties":{"attribute":{"type":"string","const":"cartSubtotal"},"operator":{"type":"string","enum":["greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"type":"number","description":"Subtotal to compare against, in the shop's currency (e.g. 50 for $50). For `between`, this is the lower bound."},"valueMax":{"description":"Upper bound. Required for `between`, ignored otherwise.","type":"number"}},"required":["attribute","operator","value"]},{"type":"object","properties":{"attribute":{"type":"string","const":"cartItemCount"},"operator":{"type":"string","enum":["greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Item count to compare against. For `between`, the lower bound."},"valueMax":{"description":"Upper bound. Required for `between`, ignored otherwise.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["attribute","operator","value"]},{"type":"object","properties":{"attribute":{"type":"string","const":"collection"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"collectionIds":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Collection ids the cart must (or must not) contain a product from. Numeric ids or gids from list_collections — the server normalizes them. A title or handle is rejected; look the collection up first."}},"required":["attribute","collectionIds"]},{"type":"object","properties":{"attribute":{"type":"string","const":"tag"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"tags":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Product tags the cart must (or must not) contain."}},"required":["attribute","tags"]},{"type":"object","properties":{"attribute":{"type":"string","const":"subscription"},"operator":{"default":"includes","description":"`includes` = cart has at least one subscription line; `doesNotInclude` = none.","type":"string","enum":["includes","doesNotInclude"]}},"required":["attribute"]},{"type":"object","properties":{"attribute":{"type":"string","const":"productId"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"products":{"minItems":1,"type":"array","items":{"type":"object","properties":{"productId":{"type":"string","description":"Shopify product id. Numeric id or gid — the server normalizes it."},"variantIds":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Variant ids of this product that count as a match. Required: a product entry with no variants can never match a cart. Get them with get_product (one call per product, works on every store) and pass all of them unless the merchant named specific variants; search_products isn't available on every store."}},"required":["productId","variantIds"]}}},"required":["attribute","products"]}],"description":"One cart condition. `anything` matches every cart and cannot be combined with other conditions.","type":"object"},"description":"The full condition list. This REPLACES the existing conditions wholesale — to add a second condition to a block, send both the existing one and the new one."}},"required":["conditions"],"description":"A cart-targeting expression: a flat list of conditions joined by all/any. The server compiles it to the stored postfix form."},{"type":"null"}]}},"required":["blockType","name","variables","styles"],"additionalProperties":false},{"type":"object","properties":{"blockType":{"type":"string","const":"faqs","description":"The block type. Picks which `variables`, `styles` and `template` values are accepted. A PUT can't change a block's type."},"name":{"type":"string","description":"Display name for identifying this block in the dashboard."},"variables":{"type":"object","properties":{"headerText":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"]}},"required":["text"]}}]},"showDivider":{"type":"boolean"},"allowMultipleOpen":{"type":"boolean"},"questions":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"question":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"]}},"required":["text"]}}]},"answer":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"]}},"required":["text"]}}]},"openByDefault":{"default":false,"type":"boolean"}},"required":["id","question","answer"]}}},"additionalProperties":false,"description":"The block's content settings, in the shape GET returns them. Replaces the stored settings: every field you leave out, at any depth, resets to the template's value. A list you send replaces the template's list whole. Unknown fields are rejected. A timer's `resetTimezone` is optional and set to the store's timezone. A store with no timezone keeps the one you send, which has to be an IANA name such as `America/New_York`. An upsell's `discount` can't be sent: the block keeps the discount saved in Intelligems."},"styles":{"type":"object","properties":{"typography":{"type":"object","properties":{"header":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"additionalProperties":false},"question":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"additionalProperties":false},"answer":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false},"backgroundColors":{"type":"object","properties":{"header":{"type":"string"},"item":{"type":"string"},"block":{"type":"string"}},"additionalProperties":false},"colors":{"type":"object","properties":{"headerText":{"type":"string"},"questionText":{"type":"string"},"answerText":{"type":"string"}},"additionalProperties":false},"layout":{"type":"object","properties":{"headerTextAlign":{"type":"string"},"bodyAlign":{"type":"string"},"itemTextAlign":{"type":"string"},"itemPositionAlign":{"type":"string"}},"additionalProperties":false},"appearance":{"type":"object","properties":{"headerBorderThickness":{"type":"string"},"headerBorderStyle":{"type":"string"},"headerCornerRadius":{"type":"string"},"headerPadding":{"type":"string"},"bodySpacing":{"type":"string"},"headingToBodySpacing":{"type":"string"},"blockBorderThickness":{"type":"string"},"blockBorderStyle":{"type":"string"},"blockPadding":{"type":"string"},"blockCornerRadius":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false,"description":"The block's style settings, in the shape GET returns them. Replaces the stored styles: every group and field you leave out resets to the template's value. Unknown groups and fields are rejected."},"displayConditions":{"description":"Cart conditions that decide when the block shows, as a condition list. Omit it to keep the current conditions, send null to remove them, or send a condition list to replace them. Don't send back the compiled `displayConditions` from GET; it is a different shape and is rejected. A block with a discount set in Intelligems keeps its conditions: sending them with an API key returns a 400.","anyOf":[{"type":"object","properties":{"match":{"default":"all","description":"`all` = every condition must hold (AND). `any` = at least one (OR).","type":"string","enum":["all","any"]},"conditions":{"minItems":1,"type":"array","items":{"oneOf":[{"type":"object","properties":{"attribute":{"type":"string","const":"anything"}},"required":["attribute"]},{"type":"object","properties":{"attribute":{"type":"string","const":"cartSubtotal"},"operator":{"type":"string","enum":["greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"type":"number","description":"Subtotal to compare against, in the shop's currency (e.g. 50 for $50). For `between`, this is the lower bound."},"valueMax":{"description":"Upper bound. Required for `between`, ignored otherwise.","type":"number"}},"required":["attribute","operator","value"]},{"type":"object","properties":{"attribute":{"type":"string","const":"cartItemCount"},"operator":{"type":"string","enum":["greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Item count to compare against. For `between`, the lower bound."},"valueMax":{"description":"Upper bound. Required for `between`, ignored otherwise.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["attribute","operator","value"]},{"type":"object","properties":{"attribute":{"type":"string","const":"collection"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"collectionIds":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Collection ids the cart must (or must not) contain a product from. Numeric ids or gids from list_collections — the server normalizes them. A title or handle is rejected; look the collection up first."}},"required":["attribute","collectionIds"]},{"type":"object","properties":{"attribute":{"type":"string","const":"tag"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"tags":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Product tags the cart must (or must not) contain."}},"required":["attribute","tags"]},{"type":"object","properties":{"attribute":{"type":"string","const":"subscription"},"operator":{"default":"includes","description":"`includes` = cart has at least one subscription line; `doesNotInclude` = none.","type":"string","enum":["includes","doesNotInclude"]}},"required":["attribute"]},{"type":"object","properties":{"attribute":{"type":"string","const":"productId"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"products":{"minItems":1,"type":"array","items":{"type":"object","properties":{"productId":{"type":"string","description":"Shopify product id. Numeric id or gid — the server normalizes it."},"variantIds":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Variant ids of this product that count as a match. Required: a product entry with no variants can never match a cart. Get them with get_product (one call per product, works on every store) and pass all of them unless the merchant named specific variants; search_products isn't available on every store."}},"required":["productId","variantIds"]}}},"required":["attribute","products"]}],"description":"One cart condition. `anything` matches every cart and cannot be combined with other conditions.","type":"object"},"description":"The full condition list. This REPLACES the existing conditions wholesale — to add a second condition to a block, send both the existing one and the new one."}},"required":["conditions"],"description":"A cart-targeting expression: a flat list of conditions joined by all/any. The server compiles it to the stored postfix form."},{"type":"null"}]}},"required":["blockType","name","variables","styles"],"additionalProperties":false},{"type":"object","properties":{"blockType":{"type":"string","const":"postPurchaseUpsell","description":"The block type. Picks which `variables`, `styles` and `template` values are accepted. A PUT can't change a block's type."},"name":{"type":"string","description":"Display name for identifying this block in the dashboard."},"variables":{"type":"object","properties":{"excludeOutOfStock":{"type":"boolean"},"excludeItemsInCart":{"type":"boolean"},"descriptionEnabled":{"type":"boolean"},"quantitySelectorEnabled":{"type":"boolean"},"countdownTimerEnabled":{"type":"boolean"},"discountType":{"description":"Not accepted with an API key. Discounts are set in Intelligems, or through the Intelligems MCP while signed in; a PUT keeps the saved discount.","not":{}},"discountValue":{"description":"Not accepted with an API key. Discounts are set in Intelligems, or through the Intelligems MCP while signed in; a PUT keeps the saved discount.","not":{}},"compareAtPriceDisplay":{"type":"string","enum":["none","compareAtPrice","regularPrice"],"description":"Struck-through price beside the offer price: 'none', 'compareAtPrice' (the product's compare-at price from Shopify), or 'regularPrice' (needs a discount)."},"bannerTitle":{"type":"string","description":"Callout banner title. New offers already show \"It's not too late to add this to your order\"; only send this when the merchant asks to change the banner. May include '#customerFirstName'. The banner hides when both title and subtitle are empty."},"bannerSubtitle":{"type":"string","description":"Callout banner subtitle. New offers already show \"Don't miss out on these picks for you\"; only send this when the merchant asks to change it."},"customerFirstNameFallback":{"type":"string","description":"Shown in place of '#customerFirstName' when the name is unknown. Only send this when the banner uses '#customerFirstName'."},"maxProductLimit":{"type":"integer","minimum":1,"maximum":10,"description":"How many products the offer shows. New offers already show 3; only send this when the merchant asks for a different number. Moving to or from 1 also turns the description on or off, unless `descriptionEnabled` is sent."},"offerTimeout":{"type":"integer","minimum":1,"maximum":60,"description":"Minutes before the offer closes and the shopper goes to the thank-you page. New offers already use 60; only send this when the merchant asks for a different time."},"headingLevel":{"type":"string","enum":["1","2","3","auto"],"description":"Heading level for the product title. Defaults to 'auto'; only send this when the merchant asks."},"imageAspectRatio":{"type":"string","enum":["original","1:1"],"description":"Product image shape. Defaults to '1:1'; only send this when the merchant asks."},"quantityLabel":{"type":"string","description":"Label above the quantity selector. Defaults to \"Quantity\"; only send this when the merchant asks to change it."},"maxQuantityType":{"type":"string","enum":["noMaximum","setMaximum"],"description":"'noMaximum' (the default), or 'setMaximum' to cap the quantity at `maxQuantity`."},"maxQuantity":{"type":"integer","minimum":1,"maximum":99,"description":"Most units a shopper can add, when `maxQuantityType` is 'setMaximum'."},"timerCheckout":{"type":"object","properties":{"countdownText":{"type":"string","description":"Copy shown while the countdown is running. Defaults to \"Offer expires in #countdownTextTimeRemaining\"; only send this when the merchant asks to change the wording. It must contain '#countdownTextTimeRemaining' where the time goes, which is replaced with the live countdown. Never use '{{...}}' placeholders."},"expiredText":{"type":"string","description":"Copy shown once the countdown ends, if `expiredBehavior` is 'showText'. Defaults to \"This offer has expired\"; only send this when the merchant asks to change it."},"durationMinutes":{"type":"integer","minimum":1,"maximum":60,"description":"Countdown length in minutes. A new countdown already gets a length that fits the offer; only send this when the merchant asks for one. Can't be longer than `offerTimeout`; a longer value is shortened to fit."},"expiredBehavior":{"type":"string","enum":["remove","showText"],"description":"What happens at zero: 'remove' hides the countdown, 'showText' (the default) swaps in `expiredText`."}},"additionalProperties":false,"description":"Countdown settings. Send only the fields the merchant asked to change; the rest keep the editor's defaults."},"discount":{"description":"Not accepted with an API key. Discounts are set in Intelligems, or through the Intelligems MCP while signed in; a PUT keeps the saved discount.","not":{}}},"additionalProperties":false,"description":"Post-purchase upsell settings. Send only the fields you want to set; the rest keep their current or default values. Values must be on the dashboard's lists and within its limits. The offer's discount (`discountType`, `discountValue`) can't be set with an API key: set it in Intelligems. A PUT keeps the saved discount."},"styles":{"type":"object","properties":{"backgroundColors":{"type":"object","properties":{"banner":{"type":"string","enum":["secondary","transparent"]},"countdown":{"type":"string","enum":["secondary","transparent"]},"expired":{"type":"string","enum":["secondary","transparent"]}},"additionalProperties":false},"colors":{"type":"object","properties":{"expiredText":{"type":"string","enum":["critical","warning","success","subdued"]}},"additionalProperties":false},"appearance":{"type":"object","properties":{"bannerTextAlign":{"type":"string","enum":["left","center","right"]},"countdownTextAlign":{"type":"string","enum":["left","center","right"]},"bannerBorderStyle":{"type":"string","enum":["none","block"]},"countdownBorderStyle":{"type":"string","enum":["none","block"]},"bannerSpacing":{"type":"string","enum":["none","tight","loose"]},"countdownSpacing":{"type":"string","enum":["none","tight","loose"]},"imageFit":{"type":"string","enum":["cover","contain"]},"imageBorder":{"type":"boolean"},"pricingAppearance":{"type":"string","enum":["default","critical","warning","success"]},"pricingEmphasized":{"type":"boolean"},"descriptionSubdued":{"type":"boolean"},"separatorWidth":{"type":"string","enum":["xtight","tight","loose","xloose"]},"secondaryButtonStyle":{"type":"string","enum":["default","subdued","plain"]}},"additionalProperties":false}},"additionalProperties":false,"description":"Post-purchase upsell styles. Send only the fields you want to set; the rest keep their current or default values. Values must be on the dashboard's lists."},"upsellProductRules":{"description":"Rules that decide which products the block recommends, in the same form as POST. Omit it to keep the current rules, send null to remove them, or send a list to replace them. Don't send back the stored `upsellProductRules` from GET; it is a different shape and is rejected. Rules can't carry a discount, and a block with a discount set in Intelligems, on the block or on its saved rules, can't have its rules replaced or removed with an API key: edit those in Intelligems.","anyOf":[{"type":"array","items":{"type":"object","properties":{"priority":{"default":0,"description":"Lower runs first; the first matching rule wins.","type":"integer","minimum":0,"maximum":9007199254740991},"when":{"type":"object","properties":{"match":{"default":"all","description":"`all` = every condition must hold (AND). `any` = at least one (OR).","type":"string","enum":["all","any"]},"conditions":{"minItems":1,"type":"array","items":{"oneOf":[{"type":"object","properties":{"attribute":{"type":"string","const":"anything"}},"required":["attribute"]},{"type":"object","properties":{"attribute":{"type":"string","const":"cartSubtotal"},"operator":{"type":"string","enum":["greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"type":"number","description":"Subtotal to compare against, in the shop's currency (e.g. 50 for $50). For `between`, this is the lower bound."},"valueMax":{"description":"Upper bound. Required for `between`, ignored otherwise.","type":"number"}},"required":["attribute","operator","value"]},{"type":"object","properties":{"attribute":{"type":"string","const":"cartItemCount"},"operator":{"type":"string","enum":["greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Item count to compare against. For `between`, the lower bound."},"valueMax":{"description":"Upper bound. Required for `between`, ignored otherwise.","type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["attribute","operator","value"]},{"type":"object","properties":{"attribute":{"type":"string","const":"collection"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"collectionIds":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Collection ids the cart must (or must not) contain a product from. Numeric ids or gids from list_collections — the server normalizes them. A title or handle is rejected; look the collection up first."}},"required":["attribute","collectionIds"]},{"type":"object","properties":{"attribute":{"type":"string","const":"tag"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"tags":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Product tags the cart must (or must not) contain."}},"required":["attribute","tags"]},{"type":"object","properties":{"attribute":{"type":"string","const":"subscription"},"operator":{"default":"includes","description":"`includes` = cart has at least one subscription line; `doesNotInclude` = none.","type":"string","enum":["includes","doesNotInclude"]}},"required":["attribute"]},{"type":"object","properties":{"attribute":{"type":"string","const":"productId"},"operator":{"default":"includes","type":"string","enum":["includes","doesNotInclude"]},"products":{"minItems":1,"type":"array","items":{"type":"object","properties":{"productId":{"type":"string","description":"Shopify product id. Numeric id or gid — the server normalizes it."},"variantIds":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Variant ids of this product that count as a match. Required: a product entry with no variants can never match a cart. Get them with get_product (one call per product, works on every store) and pass all of them unless the merchant named specific variants; search_products isn't available on every store."}},"required":["productId","variantIds"]}}},"required":["attribute","products"]}],"description":"One cart condition. `anything` matches every cart and cannot be combined with other conditions.","type":"object"},"description":"The full condition list. This REPLACES the existing conditions wholesale — to add a second condition to a block, send both the existing one and the new one."}},"required":["conditions"],"description":"Cart conditions that trigger this rule. Use a single `anything` condition for a rule that always applies."},"recommend":{"oneOf":[{"type":"object","properties":{"source":{"type":"string","const":"shopifyRecommendations"}},"required":["source"]},{"type":"object","properties":{"source":{"type":"string","const":"collection"},"collectionId":{"type":"string","description":"Collection to recommend from. Numeric id or gid from list_collections — the server normalizes it. A title or handle is rejected; look the collection up first. Singular because the renderer resolves only one collection per rule."},"tags":{"description":"Optional: narrow the collection to products carrying ALL of these tags (ANDed) — unlike a tag-source rule, where the tags are ORed.","type":"array","items":{"type":"string"}}},"required":["source","collectionId"]},{"type":"object","properties":{"source":{"type":"string","const":"tag"},"tags":{"minItems":1,"type":"array","items":{"type":"string"},"description":"Recommend products carrying ANY of these tags (they are ORed together)."}},"required":["source","tags"]},{"type":"object","properties":{"source":{"type":"string","const":"products"},"products":{"minItems":1,"type":"array","items":{"type":"object","properties":{"productId":{"type":"string","description":"Numeric id or gid; the server normalizes it."},"variantIds":{"description":"Variants to offer. Omit to offer every variant of the product.","type":"array","items":{"type":"string"}}},"required":["productId"]},"description":"Explicit products, in display order. The server hydrates titles, images and prices from Shopify — do not invent them."}},"required":["source","products"]}],"description":"Where the block's recommended products come from: Shopify's own recommendations for the cart, a collection, a tag search, or an explicit product list.","type":"object"},"discount":{"description":"Not accepted with an API key. Discounts are set in Intelligems, or through the Intelligems MCP while signed in; a PUT keeps the saved discount.","not":{}}},"required":["when","recommend"]}},{"type":"null"}]}},"required":["blockType","name","variables","styles"],"additionalProperties":false}],"type":"object"}}}},"responses":{"200":{"description":"OK","headers":{"access-control-allow-origin":{"schema":{"type":"string"},"description":"CORS allow-origin header."},"access-control-allow-credentials":{"schema":{"type":"string"},"description":"CORS allow-credentials header."},"content-type":{"schema":{"type":"string"},"description":"Response content type."},"Timing-Allow-Origin":{"schema":{"type":"string"},"description":"Allowed origin for Timing headers."},"X-RateLimit-Limit":{"schema":{"type":"string"},"description":"Maximum requests allowed in the current window."},"X-RateLimit-Remaining":{"schema":{"type":"string"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"string"},"description":"Unix timestamp (ms) when the rate limit resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"block":{"oneOf":[{"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)$","description":"Server-generated. Read-only."},"variationId":{"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":"References the parent variation."},"locationId":{"type":"string","description":"Shopify checkout extensibility target location where the block renders."},"blockType":{"type":"string","const":"trustBadge"},"blockTemplate":{"description":"The template preset this block was created from, within its block type. Null on blocks saved before templates were persisted, which callers must treat as unknown rather than assuming a default.","anyOf":[{"type":"string","enum":["badgeList","badgeTiles","callOut","grid","header","images","brandLogo","textOnly"]},{"type":"null"}]},"name":{"type":"string","description":"Display name for identifying this block in the dashboard."},"displayConditions":{"description":"Optional cart-based conditions; the block renders only when the expression evaluates true against the current cart.","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)$"},"expression":{"type":"array","items":{"type":"object","properties":{"query":{"type":"object","properties":{"key":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"type":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"filter":{"type":"string","enum":["includes","doesNotInclude","greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string"},"inclusionType":{"type":"string","enum":["include","exclude"]}},"required":["variantId","inclusionType"],"additionalProperties":false}}}]}},"required":["key","type","filter"],"additionalProperties":false},"operator":{"type":"string","enum":["and","or","start_paren","end_paren"]}},"additionalProperties":false}}},"required":["id","expression"],"additionalProperties":false},"variables":{"type":"object","properties":{"headerText":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]},"items":{"type":"array","items":{"type":"object","properties":{"order":{"type":"number"},"title":{"anyOf":[{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]},{"type":"null"}]},"subtitle":{"anyOf":[{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]},{"type":"null"}]},"type":{"type":"string"},"icon":{"type":["string","null"]},"iconColor":{"type":["string","null"]},"iconSize":{"type":["string","null"]},"imageSize":{"anyOf":[{"type":"number","minimum":1,"maximum":500},{"type":"null"}]},"imageSizeUnit":{"type":"string","enum":["pixels","percentage"]},"imageAspectRatio":{"type":["string","null"]},"image":{"type":["string","null"]},"mediaSpacing":{"type":"string"}},"required":["order","type","imageSize","imageSizeUnit","mediaSpacing"],"additionalProperties":false}}},"required":["headerText","items"],"additionalProperties":false,"description":"Configurable content for the trust badge (e.g., badge images, guarantee text)."},"styles":{"type":"object","properties":{"typography":{"type":"object","properties":{"header":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"itemTitle":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"itemSubtitle":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false}},"required":["header","itemTitle","itemSubtitle"],"additionalProperties":false},"backgroundColors":{"type":"object","properties":{"header":{"type":"string"},"item":{"type":"string"},"block":{"type":"string"}},"required":["header","item","block"],"additionalProperties":false},"colors":{"type":"object","properties":{"headerText":{"type":"string"},"itemTitleText":{"type":"string"},"itemSubtitleText":{"type":"string"}},"required":["headerText","itemTitleText","itemSubtitleText"],"additionalProperties":false},"layout":{"type":"object","properties":{"headerTextAlign":{"type":"string"},"bodyAlign":{"type":"string"},"itemTextAlign":{"type":"string"},"itemPositionAlign":{"type":"string"},"rowCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"columnCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["headerTextAlign","bodyAlign","itemTextAlign","itemPositionAlign","rowCount","columnCount"],"additionalProperties":false},"appearance":{"type":"object","properties":{"headerBorderThickness":{"type":"string"},"headerBorderStyle":{"default":"none","type":"string"},"headerCornerRadius":{"type":"string"},"headerPadding":{"type":"string"},"bodySpacing":{"type":"string"},"headingToBodySpacing":{"type":"string"},"blockBorderThickness":{"type":"string"},"blockBorderStyle":{"default":"none","type":"string"},"blockPadding":{"type":"string"},"blockCornerRadius":{"type":"string"},"itemBorderThickness":{"type":"string"},"itemBorderStyle":{"default":"none","type":"string"},"itemCornerRadius":{"type":"string"},"itemTextSpacing":{"type":"string"}},"required":["headerBorderThickness","headerBorderStyle","headerCornerRadius","headerPadding","bodySpacing","headingToBodySpacing","blockBorderThickness","blockBorderStyle","blockPadding","blockCornerRadius","itemBorderThickness","itemBorderStyle","itemCornerRadius","itemTextSpacing"],"additionalProperties":false}},"required":["typography","backgroundColors","colors","layout","appearance"],"additionalProperties":false,"description":"CSS styling overrides for the trust badge appearance."}},"required":["id","variationId","locationId","blockType","name","variables","styles"],"additionalProperties":false},{"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)$","description":"Server-generated. Read-only."},"variationId":{"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":"References the parent variation."},"locationId":{"type":"string","description":"Shopify checkout extensibility target location where the block renders."},"blockType":{"type":"string","const":"upsell"},"blockTemplate":{"description":"The template preset this block was created from, within its block type. Null on blocks saved before templates were persisted, which callers must treat as unknown rather than assuming a default.","anyOf":[{"type":"string","enum":["productTiles","productList","singleProduct","singleProductCheckbox"]},{"type":"null"}]},"name":{"type":"string","description":"Display name for identifying this block in the dashboard."},"displayConditions":{"description":"Optional cart-based conditions; the block renders only when the expression evaluates true against the current cart.","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)$"},"expression":{"type":"array","items":{"type":"object","properties":{"query":{"type":"object","properties":{"key":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"type":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"filter":{"type":"string","enum":["includes","doesNotInclude","greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string"},"inclusionType":{"type":"string","enum":["include","exclude"]}},"required":["variantId","inclusionType"],"additionalProperties":false}}}]}},"required":["key","type","filter"],"additionalProperties":false},"operator":{"type":"string","enum":["and","or","start_paren","end_paren"]}},"additionalProperties":false}}},"required":["id","expression"],"additionalProperties":false},"variables":{"type":"object","properties":{"headerText":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]},"maxProductLimit":{"default":3,"type":"integer","minimum":1,"maximum":10},"excludeItemsInCart":{"default":false,"type":"boolean"},"excludeOutOfStock":{"default":false,"type":"boolean"},"buttonText":{"type":"string"},"imageSize":{"type":"number","minimum":1,"maximum":500},"imageSizeUnit":{"type":"string","enum":["pixels","percentage"]},"imageAspectRatio":{"type":"string"},"mediaSpacing":{"type":"string"},"discount":{"type":"object","properties":{"discountType":{"default":"none","type":"string","enum":["none","percentage","fixed"]},"discountValue":{"type":["number","null"]},"compareAtPriceDisplay":{"default":"none","type":"string","enum":["none","compareAtPrice","regularPrice"]}},"required":["discountType","compareAtPriceDisplay"],"additionalProperties":false}},"required":["headerText","maxProductLimit","excludeItemsInCart","excludeOutOfStock","buttonText","imageSize","imageSizeUnit","imageAspectRatio","mediaSpacing"],"additionalProperties":false,"description":"Configurable content for the upsell block (e.g., product selection, heading text, CTA label)."},"styles":{"type":"object","properties":{"typography":{"type":"object","properties":{"header":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"productTitle":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"variantTitle":{"default":{"fontSize":"base","fontStyle":"normal"},"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"price":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"button":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false}},"required":["header","productTitle","variantTitle","price","button"],"additionalProperties":false},"backgroundColors":{"type":"object","properties":{"header":{"type":"string"},"item":{"type":"string"},"block":{"type":"string"},"button":{"default":"auto","type":"string"},"productUnit":{"type":"string"}},"required":["header","item","block","button","productUnit"],"additionalProperties":false},"colors":{"type":"object","properties":{"headerText":{"type":"string"},"productText":{"type":"string"},"variantText":{"default":"subdued","type":"string"},"priceText":{"type":"string"},"carouselArrowColor":{"default":"auto","type":"string"},"carouselArrowStyle":{"default":"primary","type":"string"}},"required":["headerText","productText","variantText","priceText","carouselArrowColor","carouselArrowStyle"],"additionalProperties":false},"layout":{"type":"object","properties":{"headerTextAlign":{"type":"string"},"bodyAlign":{"type":"string"},"itemTextAlign":{"type":"string"},"itemPositionAlign":{"type":"string"},"mobile":{"type":"object","properties":{"rowCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"columnCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["rowCount","columnCount"],"additionalProperties":false},"desktop":{"type":"object","properties":{"rowCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"columnCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["rowCount","columnCount"],"additionalProperties":false}},"required":["headerTextAlign","bodyAlign","itemTextAlign","itemPositionAlign","mobile","desktop"],"additionalProperties":false},"appearance":{"type":"object","properties":{"headerBorderThickness":{"type":"string"},"headerBorderStyle":{"default":"none","type":"string"},"headerCornerRadius":{"type":"string"},"headerPadding":{"type":"string"},"bodySpacing":{"type":"string"},"headingToBodySpacing":{"type":"string"},"blockBorderThickness":{"type":"string"},"blockBorderStyle":{"default":"none","type":"string"},"blockPadding":{"type":"string"},"blockCornerRadius":{"type":"string"},"productBorderThickness":{"type":"string"},"productBorderStyle":{"default":"none","type":"string"},"productCornerRadius":{"type":"string"},"productTextSpacing":{"type":"string"}},"required":["headerBorderThickness","headerBorderStyle","headerCornerRadius","headerPadding","bodySpacing","headingToBodySpacing","blockBorderThickness","blockBorderStyle","blockPadding","blockCornerRadius","productBorderThickness","productBorderStyle","productCornerRadius","productTextSpacing"],"additionalProperties":false}},"required":["typography","backgroundColors","colors","layout","appearance"],"additionalProperties":false,"description":"CSS styling overrides for the upsell block appearance."},"upsellProductRules":{"default":[],"description":"Product selection and recommendation rules that determine which products to show in this upsell block.","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)$"},"checkoutBlockId":{"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)$"},"priority":{"type":"integer","minimum":0,"maximum":9007199254740991},"cartTargeting":{"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)$"},"expression":{"type":"array","items":{"type":"object","properties":{"query":{"type":"object","properties":{"key":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"type":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"filter":{"type":"string","enum":["includes","doesNotInclude","greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string"},"inclusionType":{"type":"string","enum":["include","exclude"]}},"required":["variantId","inclusionType"],"additionalProperties":false}}}]}},"required":["key","type","filter"],"additionalProperties":false},"operator":{"type":"string","enum":["and","or","start_paren","end_paren"]}},"additionalProperties":false}}},"required":["id","expression"],"additionalProperties":false},"action":{"$ref":"#/components/schemas/__schema0"},"variationId":{"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)$"}},"required":["id","checkoutBlockId","priority","cartTargeting","action","variationId"],"additionalProperties":false}},"agenticLogicPlacementId":{"description":"Agentic Logic placement this block evaluates through. Absent means the legacy rule engine serves it — clearing the mapping is the per-surface rollback.","anyOf":[{"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":"null"}]},"agenticLogicRuleId":{"description":"WRITE-SIDE intent: the Agentic Logic rule this block should serve. The experience save upserts the placement and the (placement, variation) assignment from it and stamps `agenticLogicPlacementId`, so callers never assemble that pair themselves. Null detaches the block and returns it to the legacy engine. Reads echo the rule currently assigned.","anyOf":[{"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":"null"}]}},"required":["id","variationId","locationId","blockType","name","variables","styles","upsellProductRules"],"additionalProperties":false},{"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)$","description":"Server-generated. Read-only."},"variationId":{"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":"References the parent variation."},"locationId":{"type":"string","description":"Shopify checkout extensibility target location where the block renders."},"blockType":{"type":"string","const":"shippingProgressBar"},"blockTemplate":{"description":"The template preset this block was created from, within its block type. Null on blocks saved before templates were persisted, which callers must treat as unknown rather than assuming a default.","anyOf":[{"type":"string","enum":["minimal","milestones"]},{"type":"null"}]},"name":{"type":"string","description":"Display name for identifying this block in the dashboard."},"displayConditions":{"description":"Optional cart-based conditions; the block renders only when the expression evaluates true against the current cart.","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)$"},"expression":{"type":"array","items":{"type":"object","properties":{"query":{"type":"object","properties":{"key":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"type":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"filter":{"type":"string","enum":["includes","doesNotInclude","greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string"},"inclusionType":{"type":"string","enum":["include","exclude"]}},"required":["variantId","inclusionType"],"additionalProperties":false}}}]}},"required":["key","type","filter"],"additionalProperties":false},"operator":{"type":"string","enum":["and","or","start_paren","end_paren"]}},"additionalProperties":false}}},"required":["id","expression"],"additionalProperties":false},"variables":{"type":"object","properties":{"headerText":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]},"currency":{"type":"string"},"template":{"default":"minimal","type":"string","enum":["minimal","milestones"]},"tiers":{"minItems":1,"type":"array","items":{"type":"object","properties":{"threshold":{"type":"number","exclusiveMinimum":0},"message":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]},"messageComplete":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]},"activeIconId":{"type":"string"},"inactiveIconId":{"type":"string"},"breakpointText":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]}},"required":["threshold","message","messageComplete"],"additionalProperties":false}}},"required":["currency","template","tiers"],"additionalProperties":false},"styles":{"type":"object","properties":{"typography":{"type":"object","properties":{"header":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"label":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false}},"required":["header","label"],"additionalProperties":false},"backgroundColors":{"type":"object","properties":{"header":{"type":"string"},"item":{"type":"string"},"block":{"type":"string"},"milestoneIcon":{"default":"subdued","type":"string"}},"required":["header","item","block","milestoneIcon"],"additionalProperties":false},"colors":{"type":"object","properties":{"headerText":{"type":"string"},"labelText":{"type":"string"},"barTone":{"type":"string"}},"required":["headerText","labelText","barTone"],"additionalProperties":false},"layout":{"type":"object","properties":{"headerTextAlign":{"type":"string"},"bodyAlign":{"type":"string"},"itemTextAlign":{"type":"string"},"itemPositionAlign":{"type":"string"},"messageTextAlign":{"default":"center","type":"string"}},"required":["headerTextAlign","bodyAlign","itemTextAlign","itemPositionAlign","messageTextAlign"],"additionalProperties":false},"appearance":{"type":"object","properties":{"headerBorderThickness":{"type":"string"},"headerBorderStyle":{"default":"none","type":"string"},"headerCornerRadius":{"type":"string"},"headerPadding":{"type":"string"},"bodySpacing":{"type":"string"},"headingToBodySpacing":{"type":"string"},"blockBorderThickness":{"type":"string"},"blockBorderStyle":{"default":"none","type":"string"},"blockPadding":{"type":"string"},"blockCornerRadius":{"type":"string"},"milestoneIconCornerRadius":{"default":"fullyRounded","type":"string"},"milestoneIconSize":{"default":"base","type":"string"},"milestoneIconPadding":{"default":"tight","type":"string"}},"required":["headerBorderThickness","headerBorderStyle","headerCornerRadius","headerPadding","bodySpacing","headingToBodySpacing","blockBorderThickness","blockBorderStyle","blockPadding","blockCornerRadius","milestoneIconCornerRadius","milestoneIconSize","milestoneIconPadding"],"additionalProperties":false}},"required":["typography","backgroundColors","colors","layout","appearance"],"additionalProperties":false}},"required":["id","variationId","locationId","blockType","name","variables","styles"],"additionalProperties":false},{"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)$","description":"Server-generated. Read-only."},"variationId":{"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":"References the parent variation."},"locationId":{"type":"string","description":"Shopify checkout extensibility target location where the block renders."},"blockType":{"type":"string","const":"timer"},"blockTemplate":{"description":"The template preset this block was created from, within its block type. Null on blocks saved before templates were persisted, which callers must treat as unknown rather than assuming a default.","anyOf":[{"type":"string","enum":["textCountdown","digitalClock","inlinePill"]},{"type":"null"}]},"name":{"type":"string","description":"Display name for identifying this block in the dashboard."},"displayConditions":{"description":"Optional cart-based conditions; the block renders only when the expression evaluates true against the current cart.","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)$"},"expression":{"type":"array","items":{"type":"object","properties":{"query":{"type":"object","properties":{"key":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"type":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"filter":{"type":"string","enum":["includes","doesNotInclude","greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string"},"inclusionType":{"type":"string","enum":["include","exclude"]}},"required":["variantId","inclusionType"],"additionalProperties":false}}}]}},"required":["key","type","filter"],"additionalProperties":false},"operator":{"type":"string","enum":["and","or","start_paren","end_paren"]}},"additionalProperties":false}}},"required":["id","expression"],"additionalProperties":false},"variables":{"type":"object","properties":{"timerMode":{"default":"fixedDate","type":"string","enum":["fixedDate","perVisitor","recurring"]},"endDateTime":{"type":["string","null"]},"durationMinutes":{"default":15,"type":"integer","minimum":1,"maximum":9007199254740991},"resetIntervalUnit":{"anyOf":[{"type":"string","enum":["hour","day","week"]},{"type":"null"}]},"resetTimeOfDay":{"anyOf":[{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},{"type":"null"}]},"resetDayOfWeek":{"anyOf":[{"anyOf":[{"type":"number","const":1},{"type":"number","const":2},{"type":"number","const":3},{"type":"number","const":4},{"type":"number","const":5},{"type":"number","const":6},{"type":"number","const":7}]},{"type":"null"}]},"resetMinuteOfHour":{"anyOf":[{"type":"integer","minimum":0,"maximum":59},{"type":"null"}]},"resetTimezone":{"type":["string","null"]},"expiredBehavior":{"default":"showText","type":"string","enum":["remove","showText"]},"timerTemplate":{"default":"textCountdown","type":"string","enum":["textCountdown","digitalClock","inlinePill"]},"showDays":{"default":false,"type":"boolean"},"showHours":{"default":true,"type":"boolean"},"showMinutes":{"default":true,"type":"boolean"},"showSeconds":{"default":true,"type":"boolean"},"countdownText":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]},"expiredText":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]},"headline":{"default":"","anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]}},"required":["timerMode","durationMinutes","expiredBehavior","timerTemplate","showDays","showHours","showMinutes","showSeconds","countdownText","expiredText","headline"],"additionalProperties":false},"styles":{"type":"object","properties":{"typography":{"type":"object","properties":{"text":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false}},"required":["text"],"additionalProperties":false},"backgroundColors":{"type":"object","properties":{"block":{"type":"string"},"expired":{"type":"string"}},"required":["block","expired"],"additionalProperties":false},"colors":{"type":"object","properties":{"text":{"type":"string"},"expiredText":{"type":"string"},"digit":{"default":"info","type":"string"}},"required":["text","expiredText","digit"],"additionalProperties":false},"layout":{"type":"object","properties":{"textAlign":{"type":"string"}},"required":["textAlign"],"additionalProperties":false},"appearance":{"type":"object","properties":{"blockBorderStyle":{"default":"none","type":"string"},"blockBorderThickness":{"type":"string"},"blockCornerRadius":{"type":"string"},"blockPadding":{"type":"string"}},"required":["blockBorderStyle","blockBorderThickness","blockCornerRadius","blockPadding"],"additionalProperties":false},"digits":{"default":{"separator":"colon","size":"base"},"type":"object","properties":{"separator":{"default":"colon","type":"string","enum":["colon","dot","units"]},"size":{"default":"base","type":"string","enum":["small","base"]}},"required":["separator","size"],"additionalProperties":false}},"required":["typography","backgroundColors","colors","layout","appearance","digits"],"additionalProperties":false}},"required":["id","variationId","locationId","blockType","name","variables","styles"],"additionalProperties":false},{"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)$","description":"Server-generated. Read-only."},"variationId":{"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":"References the parent variation."},"locationId":{"type":"string","description":"Shopify checkout extensibility target location where the block renders."},"blockType":{"type":"string","const":"faqs"},"blockTemplate":{"description":"The template preset this block was created from, within its block type. Null on blocks saved before templates were persisted, which callers must treat as unknown rather than assuming a default.","anyOf":[{"type":"string","enum":["faqsAccordion"]},{"type":"null"}]},"name":{"type":"string","description":"Display name for identifying this block in the dashboard."},"displayConditions":{"description":"Optional cart-based conditions; the block renders only when the expression evaluates true against the current cart.","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)$"},"expression":{"type":"array","items":{"type":"object","properties":{"query":{"type":"object","properties":{"key":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"type":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"filter":{"type":"string","enum":["includes","doesNotInclude","greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string"},"inclusionType":{"type":"string","enum":["include","exclude"]}},"required":["variantId","inclusionType"],"additionalProperties":false}}}]}},"required":["key","type","filter"],"additionalProperties":false},"operator":{"type":"string","enum":["and","or","start_paren","end_paren"]}},"additionalProperties":false}}},"required":["id","expression"],"additionalProperties":false},"variables":{"type":"object","properties":{"headerText":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]},"showDivider":{"default":true,"type":"boolean"},"allowMultipleOpen":{"default":false,"type":"boolean"},"questions":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"question":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]},"answer":{"anyOf":[{"type":"string"},{"minItems":1,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"pattern":"^[^\\r\\n]*$"},"bold":{"type":"boolean"},"italic":{"type":"boolean"},"strike":{"type":"boolean"},"link":{"type":"object","properties":{"href":{"type":"string","format":"uri"}},"required":["href"],"additionalProperties":false}},"required":["text"],"additionalProperties":false}}]},"openByDefault":{"default":false,"type":"boolean"}},"required":["id","question","answer","openByDefault"],"additionalProperties":false}}},"required":["showDivider","allowMultipleOpen","questions"],"additionalProperties":false},"styles":{"type":"object","properties":{"typography":{"type":"object","properties":{"header":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"question":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"answer":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false}},"required":["header","question","answer"],"additionalProperties":false},"backgroundColors":{"type":"object","properties":{"header":{"type":"string"},"item":{"type":"string"},"block":{"type":"string"}},"required":["header","item","block"],"additionalProperties":false},"colors":{"type":"object","properties":{"headerText":{"type":"string"},"questionText":{"type":"string"},"answerText":{"type":"string"}},"required":["headerText","questionText","answerText"],"additionalProperties":false},"layout":{"type":"object","properties":{"headerTextAlign":{"type":"string"},"bodyAlign":{"type":"string"},"itemTextAlign":{"type":"string"},"itemPositionAlign":{"type":"string"}},"required":["headerTextAlign","bodyAlign","itemTextAlign","itemPositionAlign"],"additionalProperties":false},"appearance":{"type":"object","properties":{"headerBorderThickness":{"type":"string"},"headerBorderStyle":{"default":"none","type":"string"},"headerCornerRadius":{"type":"string"},"headerPadding":{"type":"string"},"bodySpacing":{"type":"string"},"headingToBodySpacing":{"type":"string"},"blockBorderThickness":{"type":"string"},"blockBorderStyle":{"default":"none","type":"string"},"blockPadding":{"type":"string"},"blockCornerRadius":{"type":"string"}},"required":["headerBorderThickness","headerBorderStyle","headerCornerRadius","headerPadding","bodySpacing","headingToBodySpacing","blockBorderThickness","blockBorderStyle","blockPadding","blockCornerRadius"],"additionalProperties":false}},"required":["typography","backgroundColors","colors","layout","appearance"],"additionalProperties":false}},"required":["id","variationId","locationId","blockType","name","variables","styles"],"additionalProperties":false},{"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)$","description":"Server-generated. Read-only."},"variationId":{"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":"References the parent variation."},"locationId":{"type":"string","description":"Shopify checkout extensibility target location where the block renders."},"blockType":{"type":"string","const":"postPurchaseUpsell"},"blockTemplate":{"description":"The template preset this block was created from, within its block type. Null on blocks saved before templates were persisted, which callers must treat as unknown rather than assuming a default.","type":"null"},"name":{"type":"string","description":"Display name for identifying this block in the dashboard."},"displayConditions":{"description":"Optional cart-based conditions; the block renders only when the expression evaluates true against the current cart.","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)$"},"expression":{"type":"array","items":{"type":"object","properties":{"query":{"type":"object","properties":{"key":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"type":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"filter":{"type":"string","enum":["includes","doesNotInclude","greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string"},"inclusionType":{"type":"string","enum":["include","exclude"]}},"required":["variantId","inclusionType"],"additionalProperties":false}}}]}},"required":["key","type","filter"],"additionalProperties":false},"operator":{"type":"string","enum":["and","or","start_paren","end_paren"]}},"additionalProperties":false}}},"required":["id","expression"],"additionalProperties":false},"variables":{"type":"object","properties":{"headerText":{"type":"string"},"discountType":{"default":"none","type":"string","enum":["none","percentage","fixed"]},"discountValue":{"type":["number","null"]},"compareAtPriceDisplay":{"default":"none","type":"string","enum":["none","compareAtPrice","regularPrice"]},"imageAspectRatio":{"type":"string"},"excludeOutOfStock":{"type":"boolean"},"excludeItemsInCart":{"type":"boolean"},"maxProductLimit":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"bannerEnabled":{"type":"boolean"},"bannerTitle":{"type":"string"},"bannerSubtitle":{"type":"string"},"customerFirstNameFallback":{"type":"string"},"compareAtPriceEnabled":{"type":"boolean"},"descriptionEnabled":{"type":"boolean"},"quantitySelectorEnabled":{"type":"boolean"},"quantityLabel":{"type":"string"},"maxQuantityType":{"type":"string"},"maxQuantity":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"moneyLineEnabled":{"default":true,"type":"boolean"},"moneyLineSubtotal":{"default":true,"type":"boolean"},"moneyLineShipping":{"default":true,"type":"boolean"},"moneyLineTaxes":{"default":true,"type":"boolean"},"primaryButtonText":{"default":"Accept offer","type":"string"},"secondaryButtonEnabled":{"default":true,"type":"boolean"},"secondaryButtonText":{"default":"Decline this offer","type":"string"},"headingLevel":{"type":"string"},"countdownTimerEnabled":{"type":"boolean"},"timerCheckout":{"type":"object","properties":{"timerMode":{"default":"fixedDate","type":"string","enum":["fixedDate","perVisitor","recurring"]},"endDateTime":{"type":["string","null"]},"durationMinutes":{"default":15,"type":"integer","minimum":1,"maximum":9007199254740991},"resetIntervalUnit":{"anyOf":[{"type":"string","enum":["hour","day","week"]},{"type":"null"}]},"resetTimeOfDay":{"anyOf":[{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},{"type":"null"}]},"resetDayOfWeek":{"anyOf":[{"anyOf":[{"type":"number","const":1},{"type":"number","const":2},{"type":"number","const":3},{"type":"number","const":4},{"type":"number","const":5},{"type":"number","const":6},{"type":"number","const":7}]},{"type":"null"}]},"resetMinuteOfHour":{"anyOf":[{"type":"integer","minimum":0,"maximum":59},{"type":"null"}]},"resetTimezone":{"type":["string","null"]},"expiredBehavior":{"default":"showText","type":"string","enum":["remove","showText"]},"timerTemplate":{"default":"textCountdown","type":"string","enum":["textCountdown","digitalClock","inlinePill"]},"showDays":{"default":false,"type":"boolean"},"showHours":{"default":true,"type":"boolean"},"showMinutes":{"default":true,"type":"boolean"},"showSeconds":{"default":true,"type":"boolean"},"countdownText":{"type":"string"},"expiredText":{"type":"string"},"headline":{"default":"","type":"string"}},"required":["timerMode","durationMinutes","expiredBehavior","timerTemplate","showDays","showHours","showMinutes","showSeconds","countdownText","expiredText","headline"],"additionalProperties":false},"offerTimeout":{"type":"number"},"discount":{"type":"object","properties":{"discountType":{"default":"none","type":"string","enum":["none","percentage","fixed"]},"discountValue":{"type":["number","null"]},"compareAtPriceDisplay":{"default":"none","type":"string","enum":["none","compareAtPrice","regularPrice"]}},"required":["discountType","compareAtPriceDisplay"],"additionalProperties":false}},"required":["headerText","discountType","compareAtPriceDisplay","imageAspectRatio","excludeOutOfStock","excludeItemsInCart","maxProductLimit","bannerEnabled","compareAtPriceEnabled","descriptionEnabled","quantitySelectorEnabled","moneyLineEnabled","moneyLineSubtotal","moneyLineShipping","moneyLineTaxes","primaryButtonText","secondaryButtonEnabled","secondaryButtonText","headingLevel"],"additionalProperties":false},"styles":{"type":"object","properties":{"typography":{"type":"object","properties":{"banner":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"productTitle":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"price":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"description":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"primaryButton":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false},"secondaryButton":{"type":"object","properties":{"fontSize":{"type":"string"},"fontStyle":{"type":"string"}},"required":["fontSize","fontStyle"],"additionalProperties":false}},"required":["productTitle","price","primaryButton"],"additionalProperties":false},"backgroundColors":{"type":"object","properties":{"banner":{"type":"string"},"primaryButton":{"type":"string"},"secondaryButton":{"type":"string"},"countdown":{"type":"string"},"expired":{"type":"string"}},"required":["banner","primaryButton"],"additionalProperties":false},"colors":{"type":"object","properties":{"bannerText":{"type":"string"},"productText":{"type":"string"},"priceText":{"type":"string"},"descriptionText":{"type":"string"},"primaryButtonText":{"type":"string"},"secondaryButtonText":{"type":"string"},"expiredText":{"type":"string"}},"required":["productText","priceText","primaryButtonText"],"additionalProperties":false},"appearance":{"type":"object","properties":{"bannerBorderStyle":{"type":"string"},"bannerSpacing":{"type":"string"},"bannerTextAlign":{"type":"string"},"separatorWidth":{"type":"string"},"imageFit":{"type":"string"},"imageBorder":{"type":"boolean"},"pricingAppearance":{"type":"string"},"pricingEmphasized":{"type":"boolean"},"pricingSubduedStyle":{"type":"boolean"},"descriptionSubdued":{"type":"boolean"},"secondaryButtonStyle":{"type":"string"},"countdownTextAlign":{"type":"string"},"countdownBorderStyle":{"type":"string"},"countdownSpacing":{"type":"string"}},"required":["bannerBorderStyle","bannerSpacing","bannerTextAlign","separatorWidth","imageFit","imageBorder","pricingEmphasized","descriptionSubdued","secondaryButtonStyle"],"additionalProperties":false}},"required":["typography","backgroundColors","colors","appearance"],"additionalProperties":false},"upsellProductRules":{"default":[],"description":"Product selection and recommendation rules that determine which products to show in this upsell block.","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)$"},"checkoutBlockId":{"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)$"},"priority":{"type":"integer","minimum":0,"maximum":9007199254740991},"cartTargeting":{"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)$"},"expression":{"type":"array","items":{"type":"object","properties":{"query":{"type":"object","properties":{"key":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"type":{"type":"string","enum":["anything","productId","collection","tag","cartSubtotal","cartItemCount","subscription"]},"filter":{"type":"string","enum":["includes","doesNotInclude","greaterThan","lessThan","equalTo","greaterThanOrEqual","lessThanOrEqual","between"]},"value":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string"},"inclusionType":{"type":"string","enum":["include","exclude"]}},"required":["variantId","inclusionType"],"additionalProperties":false}}}]}},"required":["key","type","filter"],"additionalProperties":false},"operator":{"type":"string","enum":["and","or","start_paren","end_paren"]}},"additionalProperties":false}}},"required":["id","expression"],"additionalProperties":false},"action":{"$ref":"#/components/schemas/__schema0"},"variationId":{"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)$"}},"required":["id","checkoutBlockId","priority","cartTargeting","action","variationId"],"additionalProperties":false}},"agenticLogicPlacementId":{"description":"Agentic Logic placement this block evaluates through. Absent means the legacy rule engine serves it — clearing the mapping is the per-surface rollback.","anyOf":[{"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":"null"}]},"agenticLogicRuleId":{"description":"WRITE-SIDE intent: the Agentic Logic rule this block should serve. The experience save upserts the placement and the (placement, variation) assignment from it and stamps `agenticLogicPlacementId`, so callers never assemble that pair themselves. Null detaches the block and returns it to the legacy engine. Reads echo the rule currently assigned.","anyOf":[{"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":"null"}]}},"required":["id","variationId","locationId","blockType","name","variables","styles","upsellProductRules"],"additionalProperties":false}],"description":"The saved checkout block.","type":"object"},"adjustments":{"description":"Changes the API made on its own, such as a post-purchase upsell's follow-up rules, or the products a new upsell or post-purchase upsell starts with when the request sends no rules. Absent when there are none.","type":"array","items":{"type":"string"}}},"required":["block"],"additionalProperties":false}}}},"429":{"description":"Too Many Requests","headers":{"access-control-allow-origin":{"schema":{"type":"string"},"description":"CORS allow-origin header."},"access-control-allow-credentials":{"schema":{"type":"string"},"description":"CORS allow-credentials header."},"content-type":{"schema":{"type":"string"},"description":"Response content type."},"X-RateLimit-Limit":{"schema":{"type":"string"},"description":"Maximum requests allowed in the current window."},"X-RateLimit-Remaining":{"schema":{"type":"string"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"string"},"description":"Unix timestamp (ms) when the rate limit resets."},"Retry-After":{"schema":{"type":"string"},"description":"Seconds to wait before retrying after a rate limit hit."}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"retryAfter":{"type":"number"}},"required":["error","message"]}}}}}}}}}
```

## Delete checkout block

> Deletes a checkout block.\
> \
> Deleting a block also removes its display conditions and detaches it from any Agentic Logic placement. The variation's other blocks are not changed.\
> \
> \### Response\
> \
> \`\`\`json\
> { "deleted": true, "blockId": "YOUR\_BLOCK\_ID" }\
> \`\`\`\
> \
> \### Important Notes\
> \
> \- The block must belong to the experience in the path, or the request returns a \`404\`.\
> \- Deleting a block from a running experience removes it for shoppers immediately.\
> \
> \*\*Rate Limit:\*\* 50 requests per 30s window, refilling 25 tokens every 30s.

````json
{"openapi":"3.1.0","info":{"title":"Intelligems External API v25-10-beta","version":"v25-10-beta"},"tags":[{"name":"Manage Checkout Blocks","description":"Checkout blocks are the content a `checkoutBlock` or `postPurchase` experience tests. Each block belongs to one variation. The following block types are supported:\n\n- `trustBadge` — Trust badges, guarantees, or brand logos\n- `upsell` — Product recommendations in checkout\n- `shippingProgressBar` — Progress toward free shipping\n- `timer` — A countdown timer\n- `faqs` — Collapsible questions and answers\n- `postPurchaseUpsell` — A one-click offer shown after checkout\n\n`blockType` picks which `variables` (content settings), `styles`, and `template` values a request accepts. Unknown fields are rejected with a `400` that names the field.\n\n**Create vs. replace.** `POST` keeps the template's value for every field you leave out, at any depth, so a minimal body creates a complete block. `PUT` replaces the block's content: `name`, `variables`, and `styles` are required, and every field you leave out, at any depth, resets to the template's value instead of keeping the saved one. The exception is `postPurchaseUpsell`: its `PUT` merges the fields you send onto the saved block. A post-purchase upsell may also adjust related settings on its own to stay valid, and lists what it changed in the response's `adjustments`.\n\n**Post-purchase readiness.** Adding a `postPurchaseUpsell` block checks that the store is ready for post-purchase upsells (plan, Shopify permissions, and settings), and returns a `400` listing what to fix if it isn't. API keys get no exemption from this check. Replacing an existing post-purchase upsell with `PUT` doesn't re-run it.\n\n**Discounts.** Discounts can't be set with an API key. Set an offer's discount in Intelligems, or through the Intelligems MCP while signed in. A request that sends one gets a `400`: that's an upsell's `variables.discount`, a product rule's `discount`, or a post-purchase upsell's `discountType` or `discountValue`. A `PUT` keeps the discount saved on the block, along with the settings that decide who gets it: the block's product rules and display conditions, `maxProductLimit` and `excludeItemsInCart`, and a post-purchase upsell's `maxQuantityType` and `maxQuantity`. Changing any of those on a discounted block returns a `400`. You can still rename a discounted block, change its copy and styles, and change a post-purchase upsell's `compareAtPriceDisplay`, which only changes the struck-through price shown. A block without a discount takes any change.\n\n**Display conditions and upsell rules.** `displayConditions` (when a block shows) and `upsellProductRules` (which products an `upsell` or `postPurchaseUpsell` block recommends) are written as a flat list of conditions joined by `match: \"all\"` or `\"any\"`. On `PUT`, omit a field to keep its current value, send `null` to remove it, or send a value to replace it. `postPurchaseUpsell` blocks don't use display conditions, and only `upsell` and `postPurchaseUpsell` blocks take product rules.\n\n**Reading blocks back.** `GET` returns the blocks as they are stored. Stored display conditions and product rules are in the compiled form the storefront evaluates, not the condition-list form you send, so don't send them back on `PUT`.\n\n**Live tests.** You can add, change, and delete blocks on a running experience. Changes take effect for shoppers immediately.\n\nYour organization's plan must include checkout block tests; otherwise every checkout-block endpoint returns a `403`."}],"servers":[{"url":"https://api.intelligems.io","description":"Production"}],"security":[{"intelligems_access_token":[]}],"components":{"securitySchemes":{"intelligems_access_token":{"type":"apiKey","in":"header","name":"intelligems-access-token","description":"Intelligems external API access token."}}},"paths":{"/v25-10-beta/experiences/{experienceId}/checkout-blocks/{blockId}":{"delete":{"operationId":"deleteCheckoutBlock","summary":"Delete checkout block","tags":["Manage Checkout Blocks"],"description":"Deletes a checkout block.\n\nDeleting a block also removes its display conditions and detaches it from any Agentic Logic placement. The variation's other blocks are not changed.\n\n### Response\n\n```json\n{ \"deleted\": true, \"blockId\": \"YOUR_BLOCK_ID\" }\n```\n\n### Important Notes\n\n- The block must belong to the experience in the path, or the request returns a `404`.\n- Deleting a block from a running experience removes it for shoppers immediately.\n\n**Rate Limit:** 50 requests per 30s window, refilling 25 tokens every 30s.","parameters":[{"in":"path","name":"experienceId","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)$","description":"The experience the checkout block belongs to."},"required":true,"description":"The experience the checkout block belongs to."},{"in":"path","name":"blockId","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)$","description":"The checkout block to act on. Copy it from the GET response."},"required":true,"description":"The checkout block to act on. Copy it from the GET response."}],"responses":{"200":{"description":"OK","headers":{"access-control-allow-origin":{"schema":{"type":"string"},"description":"CORS allow-origin header."},"access-control-allow-credentials":{"schema":{"type":"string"},"description":"CORS allow-credentials header."},"content-type":{"schema":{"type":"string"},"description":"Response content type."},"Timing-Allow-Origin":{"schema":{"type":"string"},"description":"Allowed origin for Timing headers."},"X-RateLimit-Limit":{"schema":{"type":"string"},"description":"Maximum requests allowed in the current window."},"X-RateLimit-Remaining":{"schema":{"type":"string"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"string"},"description":"Unix timestamp (ms) when the rate limit resets."}},"content":{"application/json":{"schema":{"type":"object","properties":{"deleted":{"type":"boolean","description":"True once the block is deleted."},"blockId":{"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":"The deleted block's id."}},"required":["deleted","blockId"],"additionalProperties":false}}}},"429":{"description":"Too Many Requests","headers":{"access-control-allow-origin":{"schema":{"type":"string"},"description":"CORS allow-origin header."},"access-control-allow-credentials":{"schema":{"type":"string"},"description":"CORS allow-credentials header."},"content-type":{"schema":{"type":"string"},"description":"Response content type."},"X-RateLimit-Limit":{"schema":{"type":"string"},"description":"Maximum requests allowed in the current window."},"X-RateLimit-Remaining":{"schema":{"type":"string"},"description":"Remaining requests in the current window."},"X-RateLimit-Reset":{"schema":{"type":"string"},"description":"Unix timestamp (ms) when the rate limit resets."},"Retry-After":{"schema":{"type":"string"},"description":"Seconds to wait before retrying after a rate limit hit."}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"retryAfter":{"type":"number"}},"required":["error","message"]}}}}}}}}}
````


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.intelligems.io/developer-resources/external-api/manage-checkout-blocks.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
