collections_edit
Change a category. Money is integer minor units (cents). Calling this changes nothing: it returns a preview of what would change and a confirmation link. Only the merchant, on that page, can make it happen.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | No | The category's name as shown in menus and at the top of its page, e.g. "Kitchen". | |
| handle | No | A new web address segment. Changing it breaks every link and search result pointing at the old one, so only when asked for. | |
| parent | No | Where it sits: a category by id, handle or exact title, or null to move it to the top level. Omit to leave it where it is. | |
| imageUrl | No | Absolute URL of the category's picture, used by menus and category tiles. Empty clears it. | |
| position | No | Its place among its siblings, 0 for first, counted among the siblings it will have after this change. Omit to keep its place. | |
| seoTitle | No | The title search results show for this category page, about 60 characters. Empty falls back to its name. | |
| isVisible | No | false hides the category from menus and listings; it still opens at its address, which is how a soft launch works. | |
| collection | Yes | The category to change, by id, handle or exact title. | |
| description | No | Plain text shown at the top of the category page. Empty clears it. | |
| seoDescription | No | The line under the title in search results, about 155 characters. Empty falls back to its description. |