*MCP › Reference › Catalog & inventory › Items* # Update the accessories of an item > Applies operations on the accessories list. > **Requires human confirmation:** Put this tool on your client's “ask before running” list. The annotations are hints that the server declares, not guarantees: do not decide the approval from `destructiveHint` alone. READ `mode` BEFORE CALLING: with `merge` —the default— the operations are deltas and what you do not name is kept; with `replace` the list sent is the final one and EVERYTHING absent is DELETED. An accessory can be another catalog item or a custom one with its name and its price. Returns the full item, with `accessoryIds` as they now stand, the same projection as its GET. TOOL `filmo_items_accessories_update` · `items:write` · 120/min · Server annotation: Destructive · Server annotation: Idempotent · Requires human confirmation ## Arguments | Name | Type | Required | Description | | --- | --- | --- | --- | | `itemId` | string | Yes | Item identifier. | | `mode` | string | No | merge (default): operations are deltas and whatever you do not name is kept. replace: the list sent is the final list and everything absent IS DELETED. `merge`, `replace` | | `targetItemVariantId` | string | No | Variant of the item the accessories apply to. | | `operations` | object[] | Yes | Operations to apply. At least one. | | `operations.accessoryId` | string | No | Existing accessory. Required to update or delete. | | `operations.action` | string | No | What to do. If omitted: with accessoryId it updates, without it it creates. `create`, `update`, `delete` | | `operations.accessory` | object | Yes | Accessory data. | | `operations.accessory.itemId` | string | No | Item that acts as the accessory. Omit it for a custom one. | | `operations.accessory.quantity` | integer | Yes | Quantity of the accessory. | | `operations.accessory.free` | boolean | Yes | true if the accessory is not charged. | | `operations.accessory.default` | boolean | Yes | true if it is added automatically when the item is put in an order. | | `operations.accessory.accessoryVariantId` | string | No | Variant of the accessory. | | `operations.accessory.isCustom` | boolean | No | true for an accessory that is not in the catalog. | | `operations.accessory.customName` | string | No | Name of the custom accessory. | | `operations.accessory.customPrice` | number | No | Unit price of the custom accessory. | | `operations.accessory.position` | integer | No | Display order. | | `idempotencyKey` | string | No | Idempotency key chosen by the client (a UUID is recommended). Repeating the same key with the same arguments within 24 h returns the stored response without executing again; with different arguments it responds 422. It is the safe way to retry after a network failure. | | `ifMatch` | string | No | Optimistic locking: the meta.etag you got from the detail read of this resource (or "*"). If the resource changed since, the call fails with 412 precondition_failed before writing anything; read it again and retry. Omit it to write unconditionally. | ## Result On success the result carries `structuredContent` with `data` and `meta`. These are the attributes of `data`. | Name | Type | Description | | --- | --- | --- | | `id` | string | Unique identifier of the item. | | `name` | string | Item name. | | `sku` | string | SKU reference of the item; null if not recorded. | | `description` | string | Item description; null if not recorded. | | `orderInfo` | string | Additional information for the order (preparation/delivery notes); null if not recorded. | | `ean` | string | EAN/barcode; null if not recorded. | | `itemType` | string | Item type: fixed (simple item) or variant (item with variants). `fixed`, `variant` | | `stockCalculationMethod` | string | Stock calculation method: bulk (in bulk, by quantity) or serialized (by serialized items). `bulk`, `serialized` | | `collectionId` | string | Identifier of the collection it belongs to; null if it is in none. | | `collectionName` | string | Name of the collection it belongs to; null if it is in none. | | `images` | string[] | URLs of the item images. | | `salePrice` | string | Sale price as a decimal string "1234.50" (ROUND_HALF_UP); null if it has none. | | `depositValue` | string | Deposit amount as a decimal string "1234.50" (ROUND_HALF_UP); null if it has none. | | `minStock` | number | Minimum stock configured for alerts; null if not configured. | | `serializedItemsCount` | number | Number of serialized items registered for the item. | | `pricingSettings` | object | Rental pricing configuration; null if not configured. | | `pricingSettings.type` | string | Pricing mode: periodPrice (price per period), fixedPrice (fixed price) or pricingStructure (pricing structure); null if the item has none configured. `periodPrice`, `fixedPrice`, `pricingStructure` | | `pricingSettings.price` | string | Base rental price as a decimal string "1234.50" (ROUND_HALF_UP); null if not applicable. | | `pricingSettings.period` | string | Period unit of the price: hour, day, week or month; null if the item has none configured. `hour`, `day`, `week`, `month` | | `insuranceEnabled` | boolean | Whether the item allows insurance. | | `discountEnabled` | boolean | Whether the item allows discounts. | | `bufferBefore` | number | Buffer time reserved before the rental; null if not applicable. | | `bufferBeforeUnit` | string | Unit of the buffer before: hour or day; null if not applicable. `hour`, `day` | | `bufferAfter` | number | Buffer time reserved after the rental; null if not applicable. | | `bufferAfterUnit` | string | Unit of the buffer after: hour or day; null if not applicable. `hour`, `day` | | `physicalProperties` | object | Physical properties (weight and dimensions); null if not recorded. | | `physicalProperties.weight` | number | Item weight in kilograms; null if not recorded. | | `physicalProperties.width` | number | Item width in centimeters; null if not recorded. | | `physicalProperties.height` | number | Item height in centimeters; null if not recorded. | | `physicalProperties.length` | number | Item length in centimeters; null if not recorded. | | `physicalProperties.volume` | number | Item volume in cubic meters (m³); null if not recorded. | | `physicalProperties.current` | number | Current draw in amperes; null if not recorded. | | `physicalProperties.power` | number | Power in watts; null if not recorded. | | `variants` | object[] | Item variants (empty if the item is of type fixed). | | `variants.variantId` | string | Unique identifier of the variant. | | `variants.variantName` | string | Variant name. | | `variants.variantPrice` | string | Rental price of the variant as a decimal string "1234.50" (ROUND_HALF_UP). | | `variants.salePrice` | string | Sale price of the variant as a decimal string "1234.50" (ROUND_HALF_UP); null if it has none. | | `variants.ean` | string | EAN/barcode of the variant; null if not recorded. | | `tags` | object[] | Tags associated with the item. | | `tags.id` | string | Unique identifier of the tag. | | `tags.name` | string | Tag name. | | `customFields` | object | Custom field values by custom field identifier; the definitions are in `/api/v1/custom-fields`. | | `createdAt` | string | Creation date in ISO 8601 with offset. | | `updatedAt` | string | Last update date in ISO 8601 with offset. | | `replacementValue` | string | Replacement value of the item as a decimal string "1234.50" (ROUND_HALF_UP); null if not recorded. | | `accessoryIds` | string[] | Identifiers of the items configured as accessories of this one. | | `alternativeIds` | string[] | Identifiers of the items configured as alternatives of this one. | *Call · filmo_items_accessories_update* ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "filmo_items_accessories_update", "arguments": { "itemId": "item_8f2a1c", "operations": [ { "accessoryId": "acce_8f2a1c", "action": "create", "accessory": { "itemId": "item_8f2a1c", "quantity": 1, "free": true, "default": true, "accessoryVariantId": "acce_8f2a1c", "isCustom": true, "customName": "Example", "customPrice": 1, "position": 1 } } ] } } } ``` *Result (generated from the schema)* ```json { "structuredContent": { "data": { "id": "id_8f2a1c", "name": "Example", "sku": "", "description": "", "orderInfo": "", "ean": "", "itemType": "fixed", "stockCalculationMethod": "bulk", "collectionId": "coll_8f2a1c", "collectionName": "Example", "images": [ "" ], "salePrice": "1234.50", "depositValue": "1234.50", "minStock": 1, "serializedItemsCount": 1, "pricingSettings": { "type": "periodPrice", "price": "1234.50", "period": "hour" }, "insuranceEnabled": true, "discountEnabled": true, "bufferBefore": 1, "bufferBeforeUnit": "hour", "bufferAfter": 1, "bufferAfterUnit": "hour", "physicalProperties": { "weight": 1, "width": 1, "height": 1, "length": 1, "volume": 1, "current": 1, "power": 1 }, "variants": [ { "variantId": "vari_8f2a1c", "variantName": "Example", "variantPrice": "1234.50", "salePrice": "1234.50", "ean": "" } ], "tags": [ { "id": "id_8f2a1c", "name": "Example" } ], "customFields": { "key": "" }, "createdAt": "2026-09-01T08:00:00Z", "updatedAt": "2026-09-01T08:00:00Z", "replacementValue": "1234.50", "accessoryIds": [ "acce_8f2a1c" ], "alternativeIds": [ "alte_8f2a1c" ] }, "meta": { "idempotencyKey": "", "rateLimit": { "limit": 120, "remaining": 119, "reset": 42 } } } } ``` ## The same operation by REST This tool runs [`PUT /api/v1/items/{itemId}/accessories`](https://docs.filmo.io/rest-api/endpoint-reference/items/update-the-accessories-of-an-item). --- Canonical URL: https://docs.filmo.io/mcp/tools/items/filmo-items-accessories-update Last updated: 2026-10-25