Import: Update Organization & Category
update_pre_publish_product_organization[Import List Product]
[What it does] Saves actual Organization, Category, or URL handle changes for one to 100 pre-publish products in one store.
[When to use] Use it after get_pre_publish_product_organization has returned the current selections and available Organization and Category choices for the same store so they can be reviewed with the user, and only after the user has chosen concrete listing changes. If the user keeps all current settings, skip this Tool.
[When not to use] To read available choices, use get_pre_publish_product_organization. To publish, use publish_products_to_stores. Product content and prices are out of scope.
[How to use]
Send all selected products in
items. Every item requiresimport_item_idand at least one actual update field:category_ids,organizations, orurl_handle.Omitted fields are preserved. Empty
category_idsororganizationsclears that setting; an emptyurl_handleclears the handle.Use only field names and value IDs returned for the same store.
create_valuescreates store-level values that may persist if a later product assignment fails.The service serializes writes to the same user and import item, rereads the latest item while holding that lock, applies only supplied fields, and performs read-after-write confirmation.
Batches may partially succeed. A successful item returns its IDs and optional
created_values; a failed item returnsfailure_code,failure_reason,failure_hint, andretryable. [Side effects] Changes product store settings and may create store-level Organization values. [Confirmation] Required but skippable; use only values the user explicitly chose.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"dsers_store_id": "<dsers_store_id>",
"items": "<items>"
},
"name": "update_pre_publish_product_organization"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes | Complete batch of one to 100 selected products for one store. Each entry requires import_item_id and at least one actual update field: category_ids, organizations, or url_handle. Omitted fields are preserved; category_ids=[] clears categories, organizations=[] clears Organization selections, and url_handle="" clears the handle. marketplace_id is category context only and does not count as an update. organizations is a complete replacement list. Do not repeat an import_item_id. Each product has an independent result, so one failure does not cancel the others. Paste JSON example: [{"import_item_id":"123456","url_handle":"my-product"}]. | |
| dsers_store_id | Yes | Copy from get_pre_publish_product_organization response. Required. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | No | Per-import-item update outcomes when batch items is used | |
| failed | No | Number of batch items that failed | |
| warnings | No | Non-blocking mutation warnings | |
| created_values | No | Store-level organization values created before assignment | |
| dsers_store_id | Yes | Updated DSers store ID | |
| import_item_id | No | Updated import-list item ID | |
| toolcall_response_at | Yes | UTC timestamp when the Tool response was returned, formatted as RFC3339. |