---
title: "Changes to Update a market"
method: PATCH
path: "/markets/{marketId}"
---

# Changes to Update a market

`PATCH /markets/{marketId}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 11 revisions.

- **2026-10-21** `b57015449446`: 1 info
- **2026-10-13** `7626ac743941`: 1 info
- **2026-07-21** `dcb0faa48534`: 5 info
- **2026-07-13** `859097ed3fe6`: 6 breaking, 10 warning, 22 info

## Changes

- **2026-10-21** `b57015449446`: 1 info
  - added the new optional request property `data/relationships/tax_calculator/oneOf[#/components/schemas/avalaraAccount]/data/attributes/pass_tax_exemption_code`
- **2026-10-13** `7626ac743941`: 1 info
  - added the new optional request property `data/relationships/tax_calculator/oneOf[#/components/schemas/vertexAccount]/data/attributes/client_id`
- **2026-07-21** `dcb0faa48534`: 5 info
  - added the new optional request property `data/relationships/tax_calculator/oneOf[#/components/schemas/externalTaxCalculator]/data/attributes/type`
  - added the new optional request property `data/relationships/tax_calculator/oneOf[#/components/schemas/manualTaxCalculator]/data/attributes/type`
  - added the new optional request property `data/relationships/tax_calculator/oneOf[#/components/schemas/stripeTaxAccount]/data/attributes/type`
  - added the new optional request property `data/relationships/tax_calculator/oneOf[#/components/schemas/taxjarAccount]/data/attributes/type`
  - added the new optional request property `data/relationships/tax_calculator/oneOf[#/components/schemas/vertexAccount]/data/attributes/type`
- **2026-07-13** `859097ed3fe6`: 6 breaking, 10 warning, 22 info
  - added the new required request property `data/relationships/customer_group/data`
  - added the new required request property `data/relationships/inventory_model/data`
  - added the new required request property `data/relationships/merchant/data`
  - added the new required request property `data/relationships/price_list/data`
  - added the new required request property `data/relationships/tax_calculator/data`
  - request property `data/type` was restricted to a list of enum values
  - removed the request property `data/relationships/customer_group/id`
  - removed the request property `data/relationships/customer_group/type`
  - removed the request property `data/relationships/inventory_model/id`
  - removed the request property `data/relationships/inventory_model/type`
  - removed the request property `data/relationships/merchant/id`
  - removed the request property `data/relationships/merchant/type`
  - removed the request property `data/relationships/price_list/id`
  - removed the request property `data/relationships/price_list/type`
  - removed the request property `data/relationships/tax_calculator/id`
  - removed the request property `data/relationships/tax_calculator/type`
  - added the new optional request property `data/attributes/_disable`
  - added the new optional request property `data/attributes/_enable`
  - added the new optional request property `data/attributes/_regenerate_shared_secret`
  - added the new optional request property `data/attributes/code`
  - added the new optional request property `data/attributes/external_includes`
  - added the new optional request property `data/attributes/external_order_validation_url`
  - added the new optional request property `data/attributes/shipping_cost_cutoff`
  - added the new optional request property `data/relationships/default_payment_method`
  - added the new optional request property `data/relationships/default_shipping_method`
  - added the new optional request property `data/relationships/discount_engine`
  - added the new optional request property `data/relationships/geocoder`
  - added the new optional request property `data/relationships/subscription_model`
  - the request property `data/attributes/checkout_url` became nullable
  - the request property `data/attributes/external_prices_url` became nullable
  - the request property `data/attributes/facebook_pixel_id` became nullable
  - the request property `data/attributes/metadata` became nullable
  - the request property `data/attributes/reference` became nullable
  - the request property `data/attributes/reference_origin` became nullable
  - the `type` request property default value `markets` was removed
  - added the new `markets` enum value to the request property `data/type`
  - added `#/components/schemas/avalaraAccount, #/components/schemas/stripeTaxAccount, #/components/schemas/vertexAccount, #/components/schemas/taxjarAccount, #/components/schemas/manualTaxCalculator, #/components/schemas/externalTaxCalculator` to the `data/relationships/tax_calculator` request property `oneOf` list
  - added the media type `application/vnd.api+json` for the response with the status `200`

---

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