---
title: "Changes to Update an attachment"
method: PATCH
path: "/attachments/{attachmentId}"
---

# Changes to Update an attachment

`PATCH /attachments/{attachmentId}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 8 of 11 revisions.

- **2026-10-21** `b57015449446`: 2 info
- **2026-10-13** `7626ac743941`: 4 info
- **2026-10-08** `71dbd5f83326`: 8 info
- **2026-09-30** `e37b77a53fd0`: 5 info
- **2026-09-03** `f4cc6ad7c61e`: 2 info
- **2026-08-25** `8c992528cc87`: 3 info
- **2026-07-21** `dcb0faa48534`: 10 info
- **2026-07-13** `859097ed3fe6`: 64 breaking, 391 warning, 1084 info

## Changes

- **2026-10-21** `b57015449446`: 2 info
  - added the new optional request property `data/relationships/attachable/oneOf[#/components/schemas/market]/data/relationships/tax_calculator/oneOf[#/components/schemas/avalaraAccount]/data/attributes/pass_tax_exemption_code`
  - added the new optional request property `data/relationships/attachable/oneOf[#/components/schemas/taxCategory]/data/relationships/tax_calculator/oneOf[#/components/schemas/avalaraAccount]/data/attributes/pass_tax_exemption_code`
- **2026-10-13** `7626ac743941`: 4 info
  - added the new optional request property `data/relationships/attachable/oneOf[#/components/schemas/lineItem]/data/relationships/item/oneOf[#/components/schemas/shipment]/data/attributes/store_shipment_policy`
  - added the new optional request property `data/relationships/attachable/oneOf[#/components/schemas/market]/data/relationships/tax_calculator/oneOf[#/components/schemas/vertexAccount]/data/attributes/client_id`
  - added the new optional request property `data/relationships/attachable/oneOf[#/components/schemas/shipment]/data/attributes/store_shipment_policy`
  - added the new optional request property `data/relationships/attachable/oneOf[#/components/schemas/taxCategory]/data/relationships/tax_calculator/oneOf[#/components/schemas/vertexAccount]/data/attributes/client_id`
- **2026-10-08** `71dbd5f83326`: 8 info
  - added the new `line_items` enum value to the request property `data/relationships/attachable/data/type`
  - added the new `payment_links` enum value to the request property `data/relationships/attachable/data/type`
  - added the new `payment_sessions` enum value to the request property `data/relationships/attachable/data/type`
  - added the new `payment_transactions` enum value to the request property `data/relationships/attachable/data/type`
  - added the new `payment_wallets` enum value to the request property `data/relationships/attachable/data/type`
  - added `#/components/schemas/lineItem, #/components/schemas/paymentSession, #/components/schemas/paymentWallet, #/components/schemas/paymentTransaction, #/components/schemas/paymentLink` to the `data/relationships/attachable` request property `oneOf` list
  - request property `data/relationships/attachable/oneOf[#/components/schemas/market]/data/relationships/order_validation_rules` reactivated
  - request property `data/relationships/attachable/oneOf[#/components/schemas/shipment]/data/relationships/shipment_line_items` reactivated
- **2026-09-30** `e37b77a53fd0`: 5 info
  - added the new optional request property `data/relationships/attachable/oneOf[#/components/schemas/order]/data/relationships/transactions/oneOf[#/components/schemas/authorization]/data/attributes/additional_data`
  - added the new optional request property `data/relationships/attachable/oneOf[#/components/schemas/order]/data/relationships/transactions/oneOf[#/components/schemas/capture]/data/attributes/additional_data`
  - added the new optional request property `data/relationships/attachable/oneOf[#/components/schemas/order]/data/relationships/transactions/oneOf[#/components/schemas/refund]/data/attributes/additional_data`
  - added the new optional request property `data/relationships/attachable/oneOf[#/components/schemas/order]/data/relationships/transactions/oneOf[#/components/schemas/void]/data/attributes/additional_data`
  - added the new optional request property `data/relationships/attachable/oneOf[#/components/schemas/transaction]/data/attributes/additional_data`
- **2026-09-03** `f4cc6ad7c61e`: 2 info
  - added the new optional request property `data/relationships/attachable/oneOf[#/components/schemas/discountEngine]/data/attributes/options`
  - added the new optional request property `data/relationships/attachable/oneOf[#/components/schemas/stockItem]/data/attributes/low_quantity`
- **2026-08-25** `8c992528cc87`: 3 info
  - added the new optional request property `data/relationships/attachable/oneOf[#/components/schemas/order]/data/attributes/formatted_subtotal_after_discount`
  - added the new optional request property `data/relationships/attachable/oneOf[#/components/schemas/order]/data/attributes/subtotal_after_discount_cents`
  - added the new optional request property `data/relationships/attachable/oneOf[#/components/schemas/order]/data/attributes/subtotal_after_discount_float`
- **2026-07-21** `dcb0faa48534`: 10 info
  - added the new optional request property `data/relationships/attachable/oneOf[#/components/schemas/market]/data/relationships/tax_calculator/oneOf[#/components/schemas/externalTaxCalculator]/data/attributes/type`
  - added the new optional request property `data/relationships/attachable/oneOf[#/components/schemas/market]/data/relationships/tax_calculator/oneOf[#/components/schemas/manualTaxCalculator]/data/attributes/type`
  - added the new optional request property `data/relationships/attachable/oneOf[#/components/schemas/market]/data/relationships/tax_calculator/oneOf[#/components/schemas/stripeTaxAccount]/data/attributes/type`
  - added the new optional request property `data/relationships/attachable/oneOf[#/components/schemas/market]/data/relationships/tax_calculator/oneOf[#/components/schemas/taxjarAccount]/data/attributes/type`
  - added the new optional request property `data/relationships/attachable/oneOf[#/components/schemas/market]/data/relationships/tax_calculator/oneOf[#/components/schemas/vertexAccount]/data/attributes/type`
  - added the new optional request property `data/relationships/attachable/oneOf[#/components/schemas/taxCategory]/data/relationships/tax_calculator/oneOf[#/components/schemas/externalTaxCalculator]/data/attributes/type`
  - added the new optional request property `data/relationships/attachable/oneOf[#/components/schemas/taxCategory]/data/relationships/tax_calculator/oneOf[#/components/schemas/manualTaxCalculator]/data/attributes/type`
  - added the new optional request property `data/relationships/attachable/oneOf[#/components/schemas/taxCategory]/data/relationships/tax_calculator/oneOf[#/components/schemas/stripeTaxAccount]/data/attributes/type`
  - added the new optional request property `data/relationships/attachable/oneOf[#/components/schemas/taxCategory]/data/relationships/tax_calculator/oneOf[#/components/schemas/taxjarAccount]/data/attributes/type`
  - added the new optional request property `data/relationships/attachable/oneOf[#/components/schemas/taxCategory]/data/relationships/tax_calculator/oneOf[#/components/schemas/vertexAccount]/data/attributes/type`
- **2026-07-13** `859097ed3fe6`: 64 breaking, 391 warning, 1084 info
  - added the new required request property `data/relationships/attachable/data`
  - request property `data/relationships/attachable/oneOf[#/components/schemas/bundle]/data/type` was restricted to a list of enum values
  - request property `data/relationships/attachable/oneOf[#/components/schemas/carrierAccount]/data/type` was restricted to a list of enum values
  - request property `data/relationships/attachable/oneOf[#/components/schemas/customerGroup]/data/type` was restricted to a list of enum values
  - request property `data/relationships/attachable/oneOf[#/components/schemas/customer]/data/attributes/status` was restricted to a list of enum values
  - request property `data/relationships/attachable/oneOf[#/components/schemas/customer]/data/type` was restricted to a list of enum values
  - request property `data/relationships/attachable/oneOf[#/components/schemas/deliveryLeadTime]/data/type` was restricted to a list of enum values
  - request property `data/relationships/attachable/oneOf[#/components/schemas/geocoder]/data/type` was restricted to a list of enum values
  - request property `data/relationships/attachable/oneOf[#/components/schemas/giftCardRecipient]/data/type` was restricted to a list of enum values
  - request property `data/relationships/attachable/oneOf[#/components/schemas/giftCard]/data/attributes/status` was restricted to a list of enum values
  - request property `data/relationships/attachable/oneOf[#/components/schemas/giftCard]/data/type` was restricted to a list of enum values
  - request property `data/relationships/attachable/oneOf[#/components/schemas/inventoryModel]/data/type` was restricted to a list of enum values
  - request property `data/relationships/attachable/oneOf[#/components/schemas/market]/data/type` was restricted to a list of enum values
  - request property `data/relationships/attachable/oneOf[#/components/schemas/merchant]/data/type` was restricted to a list of enum values
  - request property `data/relationships/attachable/oneOf[#/components/schemas/order]/data/attributes/fulfillment_status` was restricted to a list of enum values
  - request property `data/relationships/attachable/oneOf[#/components/schemas/order]/data/attributes/payment_status` was restricted to a list of enum values
  - request property `data/relationships/attachable/oneOf[#/components/schemas/order]/data/attributes/status` was restricted to a list of enum values
  - request property `data/relationships/attachable/oneOf[#/components/schemas/order]/data/relationships/payment_source/oneOf[#/components/schemas/adyenPayment]/data/type` was restricted to a list of enum values
  - request property `data/relationships/attachable/oneOf[#/components/schemas/order]/data/relationships/payment_source/oneOf[#/components/schemas/braintreePayment]/data/type` was restricted to a list of enum values
  - request property `data/relationships/attachable/oneOf[#/components/schemas/order]/data/relationships/payment_source/oneOf[#/components/schemas/checkoutComPayment]/data/type` was restricted to a list of enum values
  - request property `data/relationships/attachable/oneOf[#/components/schemas/order]/data/relationships/payment_source/oneOf[#/components/schemas/externalPayment]/data/type` was restricted to a list of enum values
  - request property `data/relationships/attachable/oneOf[#/components/schemas/order]/data/relationships/payment_source/oneOf[#/components/schemas/klarnaPayment]/data/type` was restricted to a list of enum values
  - request property `data/relationships/attachable/oneOf[#/components/schemas/order]/data/relationships/payment_source/oneOf[#/components/schemas/paypalPayment]/data/attributes/status` was restricted to a list of enum values
  - request property `data/relationships/attachable/oneOf[#/components/schemas/order]/data/relationships/payment_source/oneOf[#/components/schemas/paypalPayment]/data/type` was restricted to a list of enum values
  - request property `data/relationships/attachable/oneOf[#/components/schemas/order]/data/relationships/payment_source/oneOf[#/components/schemas/stripePayment]/data/type` was restricted to a list of enum values
  - request property `data/relationships/attachable/oneOf[#/components/schemas/order]/data/relationships/payment_source/oneOf[#/components/schemas/wireTransfer]/data/type` was restricted to a list of enum values
  - request property `data/relationships/attachable/oneOf[#/components/schemas/order]/data/relationships/transactions/oneOf[#/components/schemas/authorization]/data/type` was restricted to a list of enum values
  - request property `data/relationships/attachable/oneOf[#/components/schemas/order]/data/relationships/transactions/oneOf[#/components/schemas/capture]/data/type` was restricted to a list of enum values
  - request property `data/relationships/attachable/oneOf[#/components/schemas/order]/data/relationships/transactions/oneOf[#/components/schemas/refund]/data/type` was restricted to a list of enum values
  - request property `data/relationships/attachable/oneOf[#/components/schemas/order]/data/relationships/transactions/oneOf[#/components/schemas/void]/data/type` was restricted to a list of enum values
  - request property `data/relationships/attachable/oneOf[#/components/schemas/order]/data/type` was restricted to a list of enum values
  - request property `data/relationships/attachable/oneOf[#/components/schemas/package]/data/type` was restricted to a list of enum values
  - request property `data/relationships/attachable/oneOf[#/components/schemas/parcel]/data/attributes/unit_of_weight` was restricted to a list of enum values
  - request property `data/relationships/attachable/oneOf[#/components/schemas/parcel]/data/type` was restricted to a list of enum values
  - request property `data/relationships/attachable/oneOf[#/components/schemas/paymentMethod]/data/attributes/payment_source_type` was restricted to a list of enum values
  - request property `data/relationships/attachable/oneOf[#/components/schemas/paymentMethod]/data/type` was restricted to a list of enum values
  - request property `data/relationships/attachable/oneOf[#/components/schemas/priceList]/data/type` was restricted to a list of enum values
  - request property `data/relationships/attachable/oneOf[#/components/schemas/price]/data/type` was restricted to a list of enum values
  - request property `data/relationships/attachable/oneOf[#/components/schemas/promotion]/data/type` was restricted to a list of enum values
  - request property `data/relationships/attachable/oneOf[#/components/schemas/return]/data/attributes/status` was restricted to a list of enum values
  - …1499 more

---

[Operation](https://skmtc.dev/commercelayer/apis/commerce-layer-api/docs/attachments/:attachmentId/patch.md) - [API](https://skmtc.dev/commercelayer/apis/commerce-layer-api.md) - [Page](https://skmtc.dev/commercelayer/apis/commerce-layer-api/changes/attachments/:attachmentId/patch)