Passa al contenuto principale

Tool Commerce

Il server offre 269 tool in 31 toolset. Come collegarsi e come scegliere i toolset è in MCP di Webround Commerce. Le descrizioni dei tool vengono dall'API e sono in inglese.

Preset​

Un preset è un pacchetto con nome di toolset che stanno bene insieme.

PresetToolset
catalog (predefinito)products, product-variants, options, tags, tagvalues, attributes, collections, filters, conditions, assets, taxzones, shipping-zones, shipping-methods, warehouses
ordersorders, orderitems, return-requests, subscriptions, store-customers
marketingpromotions, conditions, feeds, reviews, cart-analytics
store-settingsstores, checkout-hooks, webhook
teamcollaborators, roles, api-keys, app-customer, app-developer

Tipi di tool​

TipoCosa viene detto al client
LetturaNon cambia niente (readOnlyHint).
ScritturaAggiunge o aggiorna, senza togliere ciò che c'era.
SostituzioneSovrascrive ciò che c'era, per esempio un PATCH che sincronizza un'intera lista (destructiveHint).
EliminazioneElimina dati (destructiveHint).

api-keys​

4 tool.

ToolTipoEndpointCosa fa
list_api_keysLetturaGET /api-keysList API Keys. Returns a paginated list of API keys for the current store. Raw key values are never returned.
create_api_keyScritturaPOST /api-keysCreate API Key. Creates a new API key. The raw key is returned only once and cannot be retrieved again.
update_api_keySostituzionePATCH /api-keys/{id}Update API Key. Updates name, scopes, active state or expiry. The token itself is immutable.
delete_api_keyEliminazioneDELETE /api-keys/{id}Revoke API Key. Permanently revokes an API key. All requests using this key will immediately fail.

app-customer​

6 tool.

ToolTipoEndpointCosa fa
app_customer_controller_find_allLetturaGET /app/customerBrowse App Catalog. Returns all published apps available in the marketplace.
app_customer_controller_find_bookmarksLetturaGET /app/customer/bookmarksList Bookmarked Apps. Returns all apps bookmarked by the current store.
app_customer_controller_launchLetturaGET /app/customer/{id}/launchGet App Launch URL. Returns a signed launch URL for the app. If the bookmark has a secret, the URL includes an HMAC signature and timestamp for the app to verify the request origin.
app_customer_controller_create_privateScritturaPOST /app/customer/privateCreate Private App. Creates a private draft app and immediately bookmarks it for this store. Does not appear in the public marketplace.
app_customer_controller_add_bookmarkScritturaPOST /app/customer/{id}/bookmarkBookmark App. Adds an app to the store backoffice. Idempotent.
app_customer_controller_remove_bookmarkEliminazioneDELETE /app/customer/{id}/bookmarkRemove Bookmark. Removes an app from the store backoffice.

app-developer​

6 tool.

ToolTipoEndpointCosa fa
app_developer_controller_find_allLetturaGET /app/developerList My Apps. Returns all apps owned by the authenticated user, regardless of status.
app_developer_controller_createScritturaPOST /app/developerCreate App. Creates a new app in draft status.
app_developer_controller_find_oneLetturaGET /app/developer/{id}Get My App. Returns a single app owned by the authenticated user.
app_developer_controller_updateSostituzionePUT /app/developer/{id}Update App. Updates an app. Only allowed when status is draft or rejected.
app_developer_controller_deleteEliminazioneDELETE /app/developer/{id}Delete App. Deletes an app. Not allowed if status is published.
app_developer_controller_submitScritturaPOST /app/developer/{id}/submitSubmit for Review. Transitions the app from draft or rejected to pending, triggering admin review.

assets​

8 tool.

ToolTipoEndpointCosa fa
list_assetsLetturaGET /assetsList All Assets. Returns a paginated list of all assets for the current store.
create_assetScritturaPOST /assetsRegister New Asset. Creates a single asset entry. Use Core APIs for binary upload.
get_assetLetturaGET /assets/{id}Get Asset Details. Retrieves metadata for a specific asset using its UUID.
update_assetSostituzionePATCH /assets/{id}Update Asset Metadata
delete_assetEliminazioneDELETE /assets/{id}Delete Asset
create_many_assetsScritturaPOST /assets/create-manyBatch Create Assets. Registers multiple assets in one request. Subject to store data limits.
delete_many_assetsScritturaPOST /assets/delete-manyBatch Delete Assets
update_many_assetsSostituzionePATCH /assets/update-manyBatch Update Assets. Updates multiple assets at once.

attributes​

8 tool.

ToolTipoEndpointCosa fa
list_attributesLetturaGET /attributesList All Attributes. Retrieves a paginated list of product attributes for the current store.
create_attributeScritturaPOST /attributesCreate Attribute. Creates a new product attribute configuration.
get_attributeLetturaGET /attributes/{id}Get Attribute Details. Retrieves full details of a specific attribute, including translations if a language code is provided.
update_attributeSostituzionePATCH /attributes/{id}Update Attribute. Updates the settings or metadata of an existing attribute.
delete_attributeEliminazioneDELETE /attributes/{id}Delete Attribute. Permanently removes an attribute. Caution: This may affect products using this attribute.
create_many_attributesScritturaPOST /attributes/batchBatch Create Attributes. Creates multiple attributes in a single request. Subject to plan data limits.
update_many_attributesSostituzionePATCH /attributes/batchBatch Update Attributes. Updates multiple attribute configurations simultaneously.
delete_many_attributesScritturaPOST /attributes/delete-manyBatch Delete Attributes. Removes a list of attributes by their IDs.

cart-analytics​

1 tool.

ToolTipoEndpointCosa fa
get_cart_analyticsLetturaGET /cart-analyticsCart Analytics Dashboard. Returns KPIs, cart list, top products, device and country breakdown for the store.

checkout-hooks​

6 tool.

ToolTipoEndpointCosa fa
list_checkout_hooksLetturaGET /checkout-hooksList Checkout Hooks. Returns the checkout hooks of this store in execution order: by position, then by creation date. Hooks without a position come after the ones that have it, ordered by creation date.
create_checkout_hook_v2ScritturaPOST /checkout-hooksCreate Checkout Hook. Creates a checkout hook with one purpose (kind): cart-transform, discount, shipping or validation. Each hook has its own secret, shown one time only. The number of hooks per kind depends on the store plan.
list_checkout_hook_v2_logsLetturaGET /checkout-hooks/logsList Checkout Hook Logs. Paginated log of the checkout hook invocations of this store, most recent first. Quote calls are logged only on error; checkout (pay) calls are always logged.
get_checkout_hook_by_idLetturaGET /checkout-hooks/{id}Get Checkout Hook. Returns one checkout hook. The secret is never returned.
update_checkout_hook_v2SostituzionePATCH /checkout-hooks/{id}Update Checkout Hook. Updates name, url, timeout, onError, position, active state or app. The kind and the secret cannot be changed.
delete_checkout_hook_v2EliminazioneDELETE /checkout-hooks/{id}Delete Checkout Hook. Permanently deletes the hook, its secret and its logs.

collaborators​

6 tool.

ToolTipoEndpointCosa fa
invite_collaboratorScritturaPOST /collaborators/inviteInvite Collaborator. Sends an invitation email to a new collaborator. Subject to store data limits.
accept_inviteLetturaGET /collaborators/acceptAccept Invitation. Validates the invitation token and joins the store.
list_collaboratorsLetturaGET /collaboratorsList Collaborators. Retrieves a paginated list of all collaborators for the current store.
remove_collaboratorEliminazioneDELETE /collaborators/{collaboratorId}Remove Collaborator. Removes a collaborator from a store.
get_rolesLetturaGET /collaborators/{collaboratorId}/rolesGet Collaborator Roles
assign_rolesSostituzionePATCH /collaborators/{collaboratorId}/rolesUpdate Collaborator Roles. Replaces current roles with the newly provided list.

collections​

10 tool.

ToolTipoEndpointCosa fa
list_collectionsLetturaGET /collectionsList Collections. Returns a paginated list of categories/collections. Supports filtering by parentId for hierarchical navigation.
create_collectionScritturaPOST /collectionsCreate Collection
get_collectionLetturaGET /collections/{id}Get Collection Details
update_collectionSostituzionePATCH /collections/{id}Update Collection
delete_collectionEliminazioneDELETE /collections/{id}Delete Collection
create_many_collectionsScritturaPOST /collections/create-manyBulk Create Collections
delete_many_collectionsScritturaPOST /collections/delete-manyBulk Delete Collections
update_many_collectionsSostituzionePATCH /collections/update-manyBulk Update Collections
collection_controller_get_filtersLetturaGET /collections/{id}/filterscollection_controller_get_filters
replace_collection_filtersSostituzionePATCH /collections/{id}/filtersLink Filters to Collection

conditions​

8 tool.

ToolTipoEndpointCosa fa
list_conditionsLetturaGET /conditionsList Conditions. Returns all product conditions defined for the current store.
create_conditionScritturaPOST /conditionsCreate Condition
get_conditionLetturaGET /conditions/{id}Get Condition
update_conditionSostituzionePATCH /conditions/{id}Update Condition
delete_conditionEliminazioneDELETE /conditions/{id}Delete Condition
create_many_conditionsScritturaPOST /conditions/batchBulk Create Conditions
update_many_conditionsSostituzionePATCH /conditions/batchBulk Update Conditions
delete_many_conditionsScritturaPOST /conditions/delete-manyBulk Delete Conditions

feeds​

6 tool.

ToolTipoEndpointCosa fa
list_feedsLetturaGET /feedsList Feeds
create_feedScritturaPOST /feedsCreate Feed
get_feedLetturaGET /feeds/{id}Get Feed
update_feedSostituzionePATCH /feeds/{id}Update Feed
delete_feedEliminazioneDELETE /feeds/{id}Delete Feed
generate_feedScritturaPOST /feeds/{id}/generateGenerate Feed. Generates the feed file on-demand and returns it as a downloadable attachment.

filters​

10 tool.

ToolTipoEndpointCosa fa
list_filtersLetturaGET /filtersList Filters. Retrieves all product filters (condition groups) for the store.
create_filterScritturaPOST /filtersCreate Filter
get_filterLetturaGET /filters/{id}Get Filter Details
update_filterSostituzionePATCH /filters/{id}Update Filter
delete_filterEliminazioneDELETE /filters/{id}Delete Filter
create_many_filtersScritturaPOST /filters/batchBulk Create Filters
update_many_filtersSostituzionePATCH /filters/batchBulk Update Filters
delete_many_filtersScritturaPOST /filters/delete-manyBulk Delete Filters
get_filter_conditionsLetturaGET /filters/{id}/conditionsGet Filter Conditions
replace_conditionsSostituzionePATCH /filters/{id}/conditionsSync Filter Conditions

options​

8 tool.

ToolTipoEndpointCosa fa
list_optionsLetturaGET /optionsList Options. Retrieves a paginated list of all product options available in the store.
create_optionScritturaPOST /optionsCreate Option
get_optionLetturaGET /options/{id}Get Option Details
update_optionSostituzionePATCH /options/{id}Update Option
delete_optionEliminazioneDELETE /options/{id}Delete Option
batch_create_optionsScritturaPOST /options/create-manyBulk Create Options
batch_delete_optionsScritturaPOST /options/delete-manyBulk Delete Options
batch_update_optionsSostituzionePATCH /options/update-manyBulk Update Options

orderitems​

6 tool.

ToolTipoEndpointCosa fa
create_many_order_itemsScritturaPOST /order-items/batchBulk Add Items. Adds multiple product items to an order in a single request.
update_many_order_itemsSostituzionePATCH /order-items/batchBulk Update Items. Updates multiple order items within the same store context.
delete_many_order_itemsScritturaPOST /order-items/delete-manyBulk Remove Items. Removes a batch of items from their respective orders using UUIDs.
create_order_itemScritturaPOST /order-itemsAdd Item to Order. Adds a specific product variant to an order with quantity and unit price.
update_order_itemSostituzionePATCH /order-items/{id}Update Item. Modifies an existing order item details like quantity or discount.
delete_order_itemEliminazioneDELETE /order-items/{id}Remove Order Item. Permanently removes a specific item from its associated order.

orders​

15 tool.

ToolTipoEndpointCosa fa
list_ordersLetturaGET /ordersList All Orders. Returns a paginated list of all orders for the current store.
create_orderScritturaPOST /ordersCreate Manual Order. Allows administrators to manually create a new order in the system.
export_ordersScritturaPOST /orders/exportExport Orders. Returns orders with their items as HTML for printing. Same filters as list, max 100 results.
create_checkout_linkScritturaPOST /orders/{id}/checkout-linkCreate Checkout Link. Returns a Stripe Checkout URL for the specific order.
get_orderLetturaGET /orders/{id}Get Order Details. Retrieves detailed information for a specific order by UUID.
update_orderSostituzionePATCH /orders/{id}Update Order. Updates metadata, status, or shipping information for an existing order.
delete_orderEliminazioneDELETE /orders/{id}Delete Order. Permanently removes an order from the store database.
get_orders_by_customerLetturaGET /orders/by-customer/{customerId}List Customer Orders. Retrieves all orders associated with a specific customer ID.
create_order_from_cartScritturaPOST /orders/from-cartCreate Manual Order From Cart. Allows administrators to manually create a new order in the system through a cart.
create_many_ordersScritturaPOST /orders/create-manyBulk Create Orders. Creates multiple orders in a single batch operation.
delete_many_ordersScritturaPOST /orders/delete-manyBulk Delete Orders. Deletes a list of orders by their UUIDs in a single request.
update_many_ordersSostituzionePATCH /orders/update-manyBulk Update Orders. Updates multiple orders simultaneously (e.g., mass status change).
get_itemsLetturaGET /orders/{orderId}/itemsGet Order Items. Retrieves all products and quantities associated with a specific order.
get_order_promotion_usagesLetturaGET /orders/{orderId}/promotion-usagesGet Order Promotion Usages. Returns the promotion usages recorded for a specific order.
sync_order_promotion_usagesSostituzionePATCH /orders/{orderId}/promotion-usagesSync Order Promotion Usages. Records that one or more promotions were used on a specific order.

product-variants​

28 tool.

ToolTipoEndpointCosa fa
list_product_variantsLetturaGET /product-variantsList Variants. Retrieves a paginated list of all product variants in the store.
create_product_variantScritturaPOST /product-variantsCreate Variant. Creates a new product variant.
get_product_variantLetturaGET /product-variants/{id}Get Variant Details. Retrieves full details for a variant, including inherited translations.
update_product_variantSostituzionePATCH /product-variants/{id}Update Variant. Updates specific variant metadata.
delete_product_variantEliminazioneDELETE /product-variants/{id}Delete Variant. Removes a variant and its local overrides.
batch_create_variantsScritturaPOST /product-variants/create-manyBulk Create Variants. Creates multiple variants in a single request.
batch_delete_variantsScritturaPOST /product-variants/delete-manyBulk Delete Variants. Removes a list of variants.
batch_update_variantsSostituzionePATCH /product-variants/update-manyBulk Update Variants. Updates multiple variants in one operation.
get_variant_assetsLetturaGET /product-variants/{id}/assetsGet Variant Assets. Retrieves assets for this variant, including inherited ones from master product.
replace_variant_assetsSostituzionePATCH /product-variants/{id}/assetsSync Variant Assets. Replaces variant-level assets.
get_variant_tagsLetturaGET /product-variants/{id}/tag-valuesGet Variant Tags. Retrieves tags for this variant with inheritance support.
replace_variant_tag_valuesSostituzionePATCH /product-variants/{id}/tag-valuesSync Variant Tags. Replaces variant-level tags.
get_variant_attributesLetturaGET /product-variants/{id}/attributesGet Variant Attributes. Retrieves custom attributes with inheritance support.
replace_variant_attribute_valuesSostituzionePATCH /product-variants/{id}/attributesSync Variant Attributes. Replaces variant-level attributes.
get_variant_shipping_methodsLetturaGET /product-variants/{id}/shipping-methodsGet Variant Shipping Methods. Retrieves specific shipping overrides.
replace_variant_shipping_methodsSostituzionePATCH /product-variants/{id}/shipping-methodsSync Variant Shipping Methods. Replaces variant-level shipping methods.
get_variant_shipping_zonesLetturaGET /product-variants/{id}/shipping-zonesGet Variant Shipping Zones. Retrieves specific shipping zone overrides.
replace_variant_shipping_zonesSostituzionePATCH /product-variants/{id}/shipping-zonesSync Variant Shipping Zones. Replaces variant-level shipping zones.
get_variant_tax_zonesLetturaGET /product-variants/{id}/tax-zonesGet Variant Tax Zones. Retrieves specific tax zone overrides.
replace_variant_tax_zonesSostituzionePATCH /product-variants/{id}/tax-zonesSync Variant Tax Zones. Replaces variant-level tax zones.
get_variant_promotion_exclusionsLetturaGET /product-variants/{id}/promotion-exclusionsGet Promotion Exclusions. Lists promotions disabled for this variant.
replace_variant_promotion_exclusionsSostituzionePATCH /product-variants/{id}/promotion-exclusionsSync Promotion Exclusions. Replaces active promotion exclusions.
get_variant_option_valuesLetturaGET /product-variants/{id}/option-valuesGet Option Values. Lists the option values that identify this variant.
replace_variant_option_valuesSostituzionePATCH /product-variants/{id}/option-valuesSync Option Values. Replaces the set of option values used to identify the variant.
get_variant_linked_pricesLetturaGET /product-variants/{id}/pricesGet Linked Prices. Lists all prices tied to the variant.
replace_variant_pricesSostituzionePATCH /product-variants/{id}/pricesSync Prices. Replaces the set of prices for this variant.
get_variant_stockLetturaGET /product-variants/{id}/stockGet Stock. Lists all the variant stock quantities.
quick_update_variant_stockSostituzionePATCH /product-variants/{id}/stock/quickQuick Update Stock. Overwrites stock on the default warehouse (or oldest) without requiring a warehouse ID.

products​

26 tool.

ToolTipoEndpointCosa fa
list_productsLetturaGET /productsList All Products. Retrieves a paginated and searchable list of all products for the current store.
create_productScritturaPOST /productsCreate Product. Initializes a new product with basic metadata and configuration.
get_productLetturaGET /products/{id}Get Product Details. Retrieves detailed information for a single product including its translations.
update_productSostituzionePATCH /products/{id}Update Product. Updates core product information for a specific UUID.
delete_productEliminazioneDELETE /products/{id}Delete Product. Permanently removes a product and all its local relations.
get_product_variantsLetturaGET /products/{id}/variantsList Product Variants. Returns a paginated list of all variants associated with a specific product.
generate_variantsScritturaPOST /products/{id}/variantsGenerate Missing Variants. Automatically creates variant Variants based on product option combinations.
create_many_productsScritturaPOST /products/create-manyBulk Create Products. Creates multiple products in a single batch operation.
delete_many_productsScritturaPOST /products/delete-manyBulk Delete Products. Removes a list of products by their UUIDs in batch.
duplicate_productScritturaPOST /products/{id}/duplicateDuplicate Product. Creates a full copy of an existing product and its configurations.
update_many_productsSostituzionePATCH /products/update-manyBulk Update Products. Updates multiple products simultaneously.
get_assetsLetturaGET /products/{id}/assetsGet Product Assets. Retrieves all images, videos, and documents linked to the product.
replace_assetsSostituzionePATCH /products/{id}/assetsSync Product Assets. Replaces all assets associated with the product.
get_tag_valuesLetturaGET /products/{id}/tag-valuesGet Product Tags. Returns all tag values currently assigned to the product.
replace_tag_valuesSostituzionePATCH /products/{id}/tag-valuesSync Product Tags. Replaces all tag value associations.
get_option_valuesLetturaGET /products/{id}/option-valuesGet Product Options. Lists all variant option values (size, color, etc.) associated with the product.
replace_option_valuesSostituzionePATCH /products/{id}/option-valuesSync Options. Replaces product variant option associations.
get_attribute_valuesLetturaGET /products/{id}/attributesGet Product Attributes. Retrieves all custom attributes and specifications for the product.
replace_attribute_valuesSostituzionePATCH /products/{id}/attributesSync Product Attributes. Replaces all product custom attributes.
get_shipping_methodsLetturaGET /products/{id}/shipping-methodsGet Product Shipping Methods. Returns the allowed shipping methods for this specific product.
replace_shipping_methodsSostituzionePATCH /products/{id}/shipping-methodsSync Product Shipping Methods. Updates allowed shipping methods for this product.
get_shipping_zonesLetturaGET /products/{id}/shipping-zonesGet Product Shipping Zones. Lists all geographical zones where this product can be shipped.
replace_shipping_zonesSostituzionePATCH /products/{id}/shipping-zonesSync Product Shipping Zones. Updates regional shipping availability.
get_tax_zonesLetturaGET /products/{id}/tax-zonesGet Product Tax Zones. Retrieves tax configuration zones applied to the product.
replace_tax_zonesSostituzionePATCH /products/{id}/tax-zonesSync Product Tax Zones. Updates tax configuration zones.
create_product_aggregateScritturaPOST /products/aggregateCreate Product Aggregate. Creates a product with all its relations (assets, tags, attributes, options, shipping, tax) and variants (with prices, stock, and their own relations) in a single atomic operation. If any part fails, the entire operation is rolled back.

promotions​

12 tool.

ToolTipoEndpointCosa fa
get_promotionsLetturaGET /promotionsList Promotions. Retrieves all active and inactive promotions for the store.
create_promotionScritturaPOST /promotionsCreate Promotion. Initializes a new promotion with its rules and reward types.
get_promotion_by_idLetturaGET /promotions/{id}Get Promotion. Returns details of a specific promotion including its current status.
update_promotionSostituzionePATCH /promotions/{id}Update Promotion. Modifies an existing promotion configuration.
delete_promotionEliminazioneDELETE /promotions/{id}Delete Promotion. Permanently removes a promotion from the system.
create_many_promotionsScritturaPOST /promotions/create-manyBulk Create Promotions. Enables batch creation of promotional campaigns.
update_many_promotionsSostituzionePATCH /promotions/update-manyBulk Update Promotions. Updates multiple promotions in a single request.
delete_many_promotionsScritturaPOST /promotions/delete-manyBulk Delete Promotions. Removes a list of promotions by ID.
get_promotion_filtersLetturaGET /promotions/{id}/filtersGet Filters. Returns all filter IDs associated with this promotion (Targeting rules).
replace_promotion_filtersSostituzionePATCH /promotions/{id}/filtersSync Filters. Synchronizes the target rules (filters) for the promotion.
apply_promotionScritturaPOST /promotions/{id}/applyApply Promotion. Triggers the calculation/application logic for the promotion. If you linked some filters, they will be used to change your catalog according to the promotion discount.
reset_promotionScritturaPOST /promotions/{id}/resetReset Promotion. Reverts the catalog data to restore the initial state present before the promotion.

return-requests​

5 tool.

ToolTipoEndpointCosa fa
list_return_requests_adminLetturaGET /return-requestsList Return Requests (Admin). Paginated list of return requests for the current store.
create_return_request_adminScritturaPOST /return-requestsCreate Return Request (Admin). Creates a return request on behalf of a customer.
get_return_request_adminLetturaGET /return-requests/{id}Get Return Request (Admin). Retrieves a single return request by ID.
update_return_request_adminSostituzionePATCH /return-requests/{id}Update Return Request (Admin). Updates status, items, reason or merchant note.
delete_return_request_adminEliminazioneDELETE /return-requests/{id}Delete Return Request (Admin). Permanently removes a return request.

reviews​

8 tool.

ToolTipoEndpointCosa fa
get_customer_reviewsLetturaGET /reviews/by-customerGet My Reviews. Retrieves all reviews written by the authenticated customer.
get_variant_reviewsLetturaGET /reviews/product-variants/{id}Get Variant Reviews. Retrieves paginated public reviews for a specific product variant.
create_reviewScritturaPOST /reviews/product-variants/{id}Create Review. Submits a new review for a product variant. One review per customer per variant.
update_reviewSostituzionePATCH /reviews/{id}Update Review. Updates an existing review owned by the authenticated customer.
delete_reviewEliminazioneDELETE /reviews/{id}Delete Review. Permanently removes a review owned by the authenticated customer.
list_store_reviewsLetturaGET /product-reviewsList Store Reviews. Returns the reviews of this store, a page at a time, with the customer's name and the variant each one is about. Filter by grade, product, variant, customer and verified purchase, and look for a customer by name, email or phone (searchText, as in the store's customers). Newest first unless said otherwise.
get_store_review_by_idLetturaGET /product-reviews/{id}Get Store Review. Returns one review of this store.
delete_store_reviewEliminazioneDELETE /product-reviews/{id}Delete Store Review. Moderation: permanently removes any review of this store, whoever wrote it. The product's grade is worked out again.

roles​

7 tool.

ToolTipoEndpointCosa fa
get_store_rolesLetturaGET /rolesList Roles. Retrieves a paginated list of all roles defined within the store context.
create_roleScritturaPOST /rolesCreate Role. Creates a new custom role for the store.
get_role_by_idLetturaGET /roles/{roleId}Get Role. Returns details of a specific role.
update_roleSostituzionePATCH /roles/{roleId}Update Role. Updates an existing role metadata.
delete_roleEliminazioneDELETE /roles/{roleId}Delete Role. Removes a role. Warning: check for assigned users before deletion.
get_role_permissionsLetturaGET /roles/{roleId}/permissionsGet Role Permissions. Retrieves the list of permissions currently granted to this role.
replace_role_permissionsSostituzionePATCH /roles/{roleId}/permissionsSync Role Permissions. Replaces the entire set of permissions for a role.

shipping-methods​

5 tool.

ToolTipoEndpointCosa fa
get_shipping_methods_getLetturaGET /shipping-methodsList Shipping Methods. Retrieves a paginated list of all shipping methods configured for the store.
create_shipping_methodScritturaPOST /shipping-methodsCreate Shipping Method. Creates a new shipping option for the customers.
get_shipping_method_by_idLetturaGET /shipping-methods/{id}Get Shipping Method. Returns details of a specific shipping method, supporting localized content.
update_shipping_methodSostituzionePATCH /shipping-methods/{id}Update Shipping Method. Modifies an existing shipping method configuration.
delete_shipping_methodEliminazioneDELETE /shipping-methods/{id}Delete Shipping Method. Removes a shipping method from the store. Note: This might affect existing orders or zone configurations.

shipping-zones​

5 tool.

ToolTipoEndpointCosa fa
get_shipping_zones_getLetturaGET /shipping-zonesList Shipping Zones. Retrieves a paginated list of all geographical shipping zones defined in the store.
create_shipping_zoneScritturaPOST /shipping-zonesCreate Shipping Zone. Registers a new shipping zone for the store.
get_shipping_zone_by_idLetturaGET /shipping-zones/{id}Get Shipping Zone. Returns the configuration of a specific shipping zone.
update_shipping_zoneSostituzionePATCH /shipping-zones/{id}Update Shipping Zone. Modifies the settings of an existing shipping zone.
delete_shipping_zoneEliminazioneDELETE /shipping-zones/{id}Delete Shipping Zone. Deletes a shipping zone. Caution: methods linked to this zone might become unreachable.

store-customers​

13 tool.

ToolTipoEndpointCosa fa
get_store_customersLetturaGET /store-customersList Customers. Retrieves a filtered, paginated list of customers.
create_store_customerScritturaPOST /store-customersCreate Customer. Manually creates a new customer profile.
get_customer_by_idLetturaGET /store-customers/{id}Get Customer. Returns full profile of a customer.
update_store_customerSostituzionePATCH /store-customers/{id}Update Customer. Updates specific customer profile data.
delete_store_customerEliminazioneDELETE /store-customers/{id}Delete Customer. Deletes a customer profile and associated local data.
customer_reset_passwordScritturaPOST /store-customers/{id}/reset-passwordSend Reset Password. Sends a password recovery email to the customer.
customer_verify_emailScritturaPOST /store-customers/{id}/verify-emailSend Verification Email. Sends an email verification link to the customer.
batch_create_customersScritturaPOST /store-customers/create-manyBulk Create Customers
batch_delete_customersScritturaPOST /store-customers/delete-manyBulk Delete Customers
batch_update_customersSostituzionePATCH /store-customers/update-manyBulk Update Customers
merge_guest_duplicatesScritturaPOST /store-customers/{id}/mergeMerge Guest Duplicates. Merges all guest customer records with the same email into the target customer. Orders, addresses and lifetime value are transferred. Guest records are deleted.
get_customer_promotionsLetturaGET /store-customers/{id}/promotionsGet Customer Promotions. Lists all promotions specifically assigned to this customer.
replace_customer_promotionsSostituzionePATCH /store-customers/{id}/promotionsSync Customer Promotions. Synchronizes the list of assigned promotions for the customer.

stores​

10 tool.

ToolTipoEndpointCosa fa
get_store_dashboard_dataLetturaGET /stores/dashboardGet Store Dashboard Data. Retrieves key metrics for the store. Defaults to the last 7 days if dates are not provided.
get_store_sitemapLetturaGET /stores/sitemapDownload Store Sitemap. Generates and downloads a ZIP file containing the Google-compliant sitemaps for the store products. Requires a paid plan.
list_owner_storesLetturaGET /stores/owner/{ownerId}List Stores By Owner. Retrieves all stores associated with a specific owner UUID. While regular users are restricted to their own ID, administrative roles (Admin, Dev, Agent) can use this to audit any user's stores.
update_storeSostituzionePATCH /stores/{id}Update Store Configuration. Updates the metadata and settings of an active store. This operation is guarded by StoreActiveGuard; inactive or suspended stores cannot be modified.
delete_storeEliminazioneDELETE /stores/{id}Delete Store. Marks the store for logical deletion. The store is immediately hidden from public view, but data is retained for a grace period to allow for potential restoration.
restore_storeScritturaPOST /stores/{id}/restoreRestore Deleted Store. Reverses a previous deletion request, bringing the store back to an active and visible state. This is only possible if the data has not been permanently purged.
store_controller_create_storeScritturaPOST /stores/{id}Create Store. Create a Webround Commerce Store starting from a draft.
store_controller_delete_imagesSostituzionePOST /stores/{id}/images/deleteDelete Store Images. Bulk delete images by asset IDs.
store_controller_create_video_uploadScritturaPOST /stores/{id}/videosRequest Video Upload. Generates a signed URL to upload a video file directly to Bunny.net.
store_controller_delete_videoEliminazioneDELETE /stores/{id}/videos/{assetId}Delete Store Video. Permanently deletes a video asset from the store and Bunny.net storage, then synchronizes the used storage space.

subscriptions​

3 tool.

ToolTipoEndpointCosa fa
subscription_controller_find_allLetturaGET /subscriptionsGet all subscriptions. Returns a paginated list of all subscriptions for the current store.
subscription_controller_find_oneLetturaGET /subscriptions/{id}Get single subscription. Retrieves specific subscription details using its UUID.
subscription_controller_find_all_by_customerLetturaGET /subscriptions/by-customer/{customerId}Get customer subscriptions. Retrieves all subscriptions associated with a specific customer ID.

tags​

8 tool.

ToolTipoEndpointCosa fa
tag_controller_find_allLetturaGET /tagsGet all tags. Retrieves a paginated list of tags for the store.
tag_controller_createScritturaPOST /tagsCreate tag. Creates a new tag for products.
tag_controller_find_oneLetturaGET /tags/{id}Get single tag. Retrieves a tag by ID with optional language translation.
tag_controller_updateSostituzionePATCH /tags/{id}Update tag. Updates an existing tag by ID.
tag_controller_deleteEliminazioneDELETE /tags/{id}Delete tag. Permanently removes a tag by ID.
tag_controller_create_manyScritturaPOST /tags/batchBatch create tags. Creates multiple tags in a single request.
tag_controller_update_manySostituzionePATCH /tags/batchBatch update tags. Updates multiple tags in a single request.
tag_controller_delete_manyScritturaPOST /tags/delete-manyBatch delete tags. Deletes multiple tags by their IDs.

tagvalues​

10 tool.

ToolTipoEndpointCosa fa
tag_value_controller_find_allLetturaGET /tag-valuesGet all tag values. Retrieves a paginated list of all tag values for the store.
tag_value_controller_createScritturaPOST /tag-valuesCreate tag value. Adds a new value entry to a tag.
tag_value_controller_find_oneLetturaGET /tag-values/{id}Get single tag value. Retrieves a specific tag value by ID with optional translation.
tag_value_controller_updateSostituzionePATCH /tag-values/{id}Update tag value. Updates an existing tag value record.
tag_value_controller_deleteEliminazioneDELETE /tag-values/{id}Delete tag value. Permanently removes a tag value.
tag_value_controller_find_by_tag_idLetturaGET /tag-values/by-tag/{tagId}Get values by tag ID. Retrieves a paginated list of values belonging to a specific tag.
tag_value_controller_create_manyScritturaPOST /tag-values/batchBatch create tag values. Creates multiple tag values in one operation.
tag_value_controller_update_manySostituzionePATCH /tag-values/batchBatch update tag values. Updates multiple tag values at once.
tag_value_controller_delete_manyScritturaPOST /tag-values/delete-manyBatch delete tag values. Removes multiple tag values by ID.
tag_value_controller_generate_filterScritturaPOST /tag-values/{id}/generate-filterGenerate filter from tag value. Creates a condition and a filter linked to the specified tag value in a single atomic operation.

taxzones​

8 tool.

ToolTipoEndpointCosa fa
tax_zone_controller_find_allLetturaGET /tax-zonesGet all tax zones. Retrieves a paginated list of tax zones for the current store.
tax_zone_controller_createScritturaPOST /tax-zonesCreate tax zone. Creates a new tax zone entry.
tax_zone_controller_find_oneLetturaGET /tax-zones/{id}Get single tax zone. Retrieves specific details for a tax zone using its ID.
tax_zone_controller_updateSostituzionePATCH /tax-zones/{id}Update tax zone. Updates an existing tax zone record.
tax_zone_controller_deleteEliminazioneDELETE /tax-zones/{id}Delete tax zone. Permanently removes a tax zone.
tax_zone_controller_create_manyScritturaPOST /tax-zones/batchBatch create tax zones. Creates multiple tax zones in a single request.
tax_zone_controller_update_manySostituzionePATCH /tax-zones/batchBatch update tax zones. Updates multiple tax zones in bulk.
tax_zone_controller_delete_manyScritturaPOST /tax-zones/delete-manyBatch delete tax zones. Removes multiple tax zones by ID list.

warehouses​

7 tool.

ToolTipoEndpointCosa fa
warehouse_controller_get_warehousesLetturaGET /warehousesList all warehouses. Retrieves a paginated list of all warehouses associated with the store.
warehouse_controller_createScritturaPOST /warehousesCreate warehouse. Adds a new physical or virtual warehouse to the store.
warehouse_controller_find_oneLetturaGET /warehouses/{id}Get warehouse details. Finds a specific warehouse by ID.
warehouse_controller_updateSostituzionePATCH /warehouses/{id}Update warehouse. Updates warehouse configuration and metadata.
warehouse_controller_deleteEliminazioneDELETE /warehouses/{id}Delete warehouse. Removes a warehouse entry from the store.
warehouse_controller_update_variant_stockSostituzionePATCH /warehouses/stockUpdate Variant Stock. Updates the inventory count for a specific varinat in a warehouse.
warehouse_controller_get_variants_in_warehouseLetturaGET /warehouses/{id}/stockList Variants in warehouse. Retrieves all product Variants and their stock levels for a specific warehouse.

webhook​

6 tool.

ToolTipoEndpointCosa fa
webhook_controller_get_webhooksLetturaGET /webhooksGet all webhooks. Returns the list of all configured webhooks for the store.
webhook_controller_createScritturaPOST /webhooksCreate webhook. Registers a new webhook endpoint to listen for store events.
webhook_controller_get_webhook_eventsLetturaGET /webhooks/eventsGet webhook events. Retrieves a paginated list of all webhook events and delivery attempts.
webhook_controller_replay_eventScritturaPOST /webhooks/events/{id}/replayReplay webhook event. Manually triggers a retry for a specific webhook event delivery.
webhook_controller_updateSostituzionePATCH /webhooks/{id}Update webhook. Updates an existing webhook configuration (URL, events, active status).
webhook_controller_deleteEliminazioneDELETE /webhooks/{id}Delete webhook. Permanently removes a webhook configuration.