commerce_live_cards_apply

# commerce_live_cards_apply

Creates, edits, shows or hides, orders or removes conversion product cards, including their images in the Commerce Live app (pApp C00014). Shows a preview first; the change runs only after confirmation. Called without confirmToken it previews and returns a confirmToken; repeating the same input with it executes once.

## Inputs

| Field | Required here | Contract |
| --- | --- | --- |
| `action` | Yes | object |
| `action.kind` | Yes | `products` |
| `action.change` | Yes | one of: `create`, `edit`, `visibility`, `order`, `remove` (by `operation`) |
| `action.change.title` | Yes | When `action.change.operation` is `create`: string; min length 1; max length 200 |
| `action.change.linkSrc` | Yes | When `action.change.operation` is `create`: string; max length 4096; format `uri` |
| `action.change.price` | No | When `action.change.operation` is `create`: `` or string; max length 32; pattern `^(?:[0-9]+\|[1-9][0-9]{0,2}(?:,[0-9]{3})+)$`; default `` |
| `action.change.discountPrice` | Yes | When `action.change.operation` is `create`: string; max length 32; pattern `^(?:[0-9]+\|[1-9][0-9]{0,2}(?:,[0-9]{3})+)$` |
| `action.change.isOpen` | No | When `action.change.operation` is `create`: boolean; default `false` |
| `action.change.image` | Yes | When `action.change.operation` is `create`: object |
| `action.change.image.filename` | Yes | When `action.change.operation` is `create`: string; min length 1; max length 240; pattern `^[^/\\:\x00-\x1f\x7f]+\.(?:png\|jpe?g)$` |
| `action.change.image.base64` | Yes | When `action.change.operation` is `create`: string; min length 4; max length 13333332 |
| `action.change.productId` | Yes | When `action.change.operation` is `edit`: integer; greater than 0 |
| `action.change.changes` | Yes | When `action.change.operation` is `edit`: object |
| `action.change.changes.title` | No | When `action.change.operation` is `edit`: string; min length 1; max length 200 |
| `action.change.changes.linkSrc` | No | When `action.change.operation` is `edit`: string; max length 4096; format `uri` |
| `action.change.changes.price` | No | When `action.change.operation` is `edit`: `` or string; max length 32; pattern `^(?:[0-9]+\|[1-9][0-9]{0,2}(?:,[0-9]{3})+)$` |
| `action.change.changes.discountPrice` | No | When `action.change.operation` is `edit`: string; max length 32; pattern `^(?:[0-9]+\|[1-9][0-9]{0,2}(?:,[0-9]{3})+)$` |
| `action.change.changes.image` | No | When `action.change.operation` is `edit`: object |
| `action.change.changes.image.filename` | Yes | When `action.change.operation` is `edit`: string; min length 1; max length 240; pattern `^[^/\\:\x00-\x1f\x7f]+\.(?:png\|jpe?g)$` |
| `action.change.changes.image.base64` | Yes | When `action.change.operation` is `edit`: string; min length 4; max length 13333332 |
| `action.change.productId` | Yes | When `action.change.operation` is `visibility`: integer; greater than 0 |
| `action.change.isOpen` | Yes | When `action.change.operation` is `visibility`: boolean |
| `action.change.productIds` | Yes | When `action.change.operation` is `order`: array; items: integer; greater than 0; min items 1; max items 20 |
| `action.change.productId` | Yes | When `action.change.operation` is `remove`: integer; greater than 0 |
| `action.change.confirmation` | Yes | When `action.change.operation` is `remove`: `REMOVE_PRODUCT` |
| `confirmToken` | No | string; pattern `^ct[a-f\d]{32}$`; The confirmToken from this tool's preview result. Omit it to preview; repeat the same input with it to execute. |