---
title: "Changes to Update customer by ID"
method: PATCH
path: "/customers/{customerId}"
---

# Changes to Update customer by ID

`PATCH /customers/{customerId}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 8 of 24 revisions.

- **2026-08-15** `27ff0fdca01c` — 6 warning, 6 info
- **2026-08-14** `aaa1fb8782c8` — 1 warning
- **2026-08-13** `df12ec487f0e` — 1 warning
- **2026-08-11** `b06902b6595a` — 4 warning
- **2026-08-06** `526036c12609` — 1 warning, 10 info
- **2026-07-31** `b21ed434ee6e` — 4 breaking, 21 warning, 6 info
- **2026-07-26** `094458a989d2` — 1 warning
- **2026-07-21** `483d0a08414b` — 1 warning

## Changes

- **2026-08-15** `27ff0fdca01c` — 6 warning, 6 info
  - removed the request property `oneOf[subschema #1: Individual Customer Update Request]/allOf[#/components/schemas/IndividualCustomerFields]/allOf[subschema #1]/taxIdCountryOfIssuance`
  - removed the request property `oneOf[subschema #1: Individual Customer Update Request]/allOf[#/components/schemas/IndividualCustomerFields]/allOf[subschema #1]/taxIdType`
  - removed the request property `oneOf[subschema #1: Individual Customer Update Request]/allOf[#/components/schemas/IndividualCustomerFields]/allOf[subschema #1]/taxIdentifier`
  - removed the optional property `oneOf[subschema #1: Individual Customer]/allOf[#/components/schemas/IndividualCustomerFields]/allOf[subschema #1]/taxIdCountryOfIssuance` from the response with the `200` status
  - removed the optional property `oneOf[subschema #1: Individual Customer]/allOf[#/components/schemas/IndividualCustomerFields]/allOf[subschema #1]/taxIdType` from the response with the `200` status
  - removed the optional property `oneOf[subschema #1: Individual Customer]/allOf[#/components/schemas/IndividualCustomerFields]/allOf[subschema #1]/taxIdentifier` from the response with the `200` status
  - added the new optional request property `oneOf[subschema #1: Individual Customer Update Request]/allOf[#/components/schemas/IndividualCustomerFields]/allOf[subschema #1]/countryOfIssuance`
  - added the new optional request property `oneOf[subschema #1: Individual Customer Update Request]/allOf[#/components/schemas/IndividualCustomerFields]/allOf[subschema #1]/idType`
  - added the new optional request property `oneOf[subschema #1: Individual Customer Update Request]/allOf[#/components/schemas/IndividualCustomerFields]/allOf[subschema #1]/identifier`
  - added the optional property `oneOf[subschema #1: Individual Customer]/allOf[#/components/schemas/IndividualCustomerFields]/allOf[subschema #1]/countryOfIssuance` to the response with the `200` status
  - added the optional property `oneOf[subschema #1: Individual Customer]/allOf[#/components/schemas/IndividualCustomerFields]/allOf[subschema #1]/idType` to the response with the `200` status
  - added the optional write-only property `oneOf[subschema #1: Individual Customer]/allOf[#/components/schemas/IndividualCustomerFields]/allOf[subschema #1]/identifier` to the response with the `200` status
- **2026-08-14** `aaa1fb8782c8` — 1 warning
  - added the new `EXTERNAL_ACCOUNT_VERIFICATION_REQUIRED` enum value to the `code` response property for the response status `400`
- **2026-08-13** `df12ec487f0e` — 1 warning
  - added the new `TRANSACTION_SIZE_LIMIT_EXCEEDED` enum value to the `code` response property for the response status `400`
- **2026-08-11** `b06902b6595a` — 4 warning
  - added the new `CARDHOLDER_KYC_NOT_APPROVED` enum value to the `code` response property for the response status `400`
  - added the new `CARD_ALREADY_CLOSED` enum value to the `code` response property for the response status `409`
  - added the new `CARD_NOT_MUTABLE` enum value to the `code` response property for the response status `409`
  - added the new `INVALID_STATE_TRANSITION` enum value to the `code` response property for the response status `409`
- **2026-08-06** `526036c12609` — 1 warning, 10 info
  - added the new `END_USER_TERMS_VERSION_NOT_FOUND` enum value to the `code` response property for the response status `400`
  - added the new optional request property `oneOf[subschema #1: Individual Customer Update Request]/allOf[subschema #1: Customer Update Request]/endUserTermsConsent`
  - added the new optional request property `oneOf[subschema #2: Business Customer Update Request]/allOf[#/components/schemas/BusinessCustomerFields]/businessInfo/primaryContactFirstName`
  - added the new optional request property `oneOf[subschema #2: Business Customer Update Request]/allOf[#/components/schemas/BusinessCustomerFields]/businessInfo/primaryContactLastName`
  - added the new optional request property `oneOf[subschema #2: Business Customer Update Request]/allOf[subschema #1: Customer Update Request]/endUserTermsConsent`
  - added the optional property `oneOf[subschema #1: Individual Customer]/allOf[#/components/schemas/Customer]/endUserTermsConsent` to the response with the `200` status
  - added the optional property `oneOf[subschema #2: Business Customer]/allOf[#/components/schemas/BusinessCustomerFields]/businessInfo/primaryContactFirstName` to the response with the `200` status
  - added the optional property `oneOf[subschema #2: Business Customer]/allOf[#/components/schemas/BusinessCustomerFields]/businessInfo/primaryContactLastName` to the response with the `200` status
  - added the optional property `oneOf[subschema #2: Business Customer]/allOf[#/components/schemas/Customer]/endUserTermsConsent` to the response with the `200` status
  - added the optional property `oneOf[subschema #2: Business Customer]/allOf[subschema #3]/businessInfo/primaryContactFirstName` to the response with the `200` status
  - added the optional property `oneOf[subschema #2: Business Customer]/allOf[subschema #3]/businessInfo/primaryContactLastName` to the response with the `200` status
- **2026-07-31** `b21ed434ee6e` — 4 breaking, 21 warning, 6 info
  - added `#/components/schemas/CustomerEdd, subschema #1` to the `oneOf[subschema #1: Individual Customer Update Request]/allOf[#/components/schemas/IndividualCustomerFields]/` request property `allOf` list
  - the `oneOf[subschema #1: Individual Customer Update Request]/allOf[#/components/schemas/IndividualCustomerFields]/` request property type/format changed from `object`/`` to ``/``
  - the `oneOf[subschema #1: Individual Customer]/allOf[#/components/schemas/IndividualCustomerFields]/` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - removed the required property `oneOf[subschema #1: Individual Customer]/allOf[#/components/schemas/IndividualCustomerFields]/customerType` from the response with the `200` status
  - removed the request property `oneOf[subschema #1: Individual Customer Update Request]/allOf[#/components/schemas/IndividualCustomerFields]/address`
  - removed the request property `oneOf[subschema #1: Individual Customer Update Request]/allOf[#/components/schemas/IndividualCustomerFields]/birthDate`
  - removed the request property `oneOf[subschema #1: Individual Customer Update Request]/allOf[#/components/schemas/IndividualCustomerFields]/customerType`
  - removed the request property `oneOf[subschema #1: Individual Customer Update Request]/allOf[#/components/schemas/IndividualCustomerFields]/fullName`
  - removed the request property `oneOf[subschema #1: Individual Customer Update Request]/allOf[#/components/schemas/IndividualCustomerFields]/kycStatus`
  - removed the request property `oneOf[subschema #1: Individual Customer Update Request]/allOf[#/components/schemas/IndividualCustomerFields]/nationality`
  - removed the optional property `oneOf[subschema #1: Individual Customer]/allOf[#/components/schemas/IndividualCustomerFields]/address` from the response with the `200` status
  - removed the optional property `oneOf[subschema #1: Individual Customer]/allOf[#/components/schemas/IndividualCustomerFields]/birthDate` from the response with the `200` status
  - removed the optional property `oneOf[subschema #1: Individual Customer]/allOf[#/components/schemas/IndividualCustomerFields]/fullName` from the response with the `200` status
  - removed the optional property `oneOf[subschema #1: Individual Customer]/allOf[#/components/schemas/IndividualCustomerFields]/kycStatus` from the response with the `200` status
  - removed the optional property `oneOf[subschema #1: Individual Customer]/allOf[#/components/schemas/IndividualCustomerFields]/nationality` from the response with the `200` status
  - added the new `BENEFICIARY_TRUSTED` enum value to the `code` response property for the response status `409`
  - added the new `CHARITY` enum value to the `oneOf[subschema #2: Business Customer]/allOf[#/components/schemas/BusinessCustomerFields]/businessInfo/entityType` response property for the response status `200`
  - added the new `CHARITY` enum value to the `oneOf[subschema #2: Business Customer]/allOf[subschema #3]/businessInfo/entityType` response property for the response status `200`
  - added the new `PRIVATE_FOUNDATION` enum value to the `oneOf[subschema #2: Business Customer]/allOf[#/components/schemas/BusinessCustomerFields]/businessInfo/entityType` response property for the response status `200`
  - added the new `PRIVATE_FOUNDATION` enum value to the `oneOf[subschema #2: Business Customer]/allOf[subschema #3]/businessInfo/entityType` response property for the response status `200`
  - added the new `PUBLICLY_LISTED_COMPANY` enum value to the `oneOf[subschema #2: Business Customer]/allOf[#/components/schemas/BusinessCustomerFields]/businessInfo/entityType` response property for the response status `200`
  - added the new `PUBLICLY_LISTED_COMPANY` enum value to the `oneOf[subschema #2: Business Customer]/allOf[subschema #3]/businessInfo/entityType` response property for the response status `200`
  - added the new `SCA_SESSION_REQUIRED` enum value to the `code` response property for the response status `409`
  - added the new `TRUST` enum value to the `oneOf[subschema #2: Business Customer]/allOf[#/components/schemas/BusinessCustomerFields]/businessInfo/entityType` response property for the response status `200`
  - added the new `TRUST` enum value to the `oneOf[subschema #2: Business Customer]/allOf[subschema #3]/businessInfo/entityType` response property for the response status `200`
  - added the new `CHARITY` enum value to the request property `oneOf[subschema #2: Business Customer Update Request]/allOf[#/components/schemas/BusinessCustomerFields]/businessInfo/entityType`
  - added the new `PRIVATE_FOUNDATION` enum value to the request property `oneOf[subschema #2: Business Customer Update Request]/allOf[#/components/schemas/BusinessCustomerFields]/businessInfo/entityType`
  - added the new `PUBLICLY_LISTED_COMPANY` enum value to the request property `oneOf[subschema #2: Business Customer Update Request]/allOf[#/components/schemas/BusinessCustomerFields]/businessInfo/entityType`
  - added the new `TRUST` enum value to the request property `oneOf[subschema #2: Business Customer Update Request]/allOf[#/components/schemas/BusinessCustomerFields]/businessInfo/entityType`
  - added the optional property `details/errors` to the response with the `400` status
  - added `#/components/schemas/CustomerEdd, subschema #1` to the `oneOf[subschema #1: Individual Customer]/allOf[#/components/schemas/IndividualCustomerFields]/` response property `allOf` list for the response status `200`
- **2026-07-26** `094458a989d2` — 1 warning
  - added the new `TRANSACTION_NOT_CANCELLABLE` enum value to the `code` response property for the response status `409`
- **2026-07-21** `483d0a08414b` — 1 warning
  - added the new `PASSKEY_ALREADY_ENROLLED` enum value to the `code` response property for the response status `409`

---

[Operation](https://skmtc.dev/stainless-api/apis/grid-api/docs/customers/:customerId/patch.md) · [API](https://skmtc.dev/stainless-api/apis/grid-api.md) · [Page](https://skmtc.dev/stainless-api/apis/grid-api/changes/customers/:customerId/patch)
