---
title: "Changes to Update KYB Identity"
method: PATCH
path: "/api/identity-service/v1/identities/{identityId}"
---

# Changes to Update KYB Identity

`PATCH /api/identity-service/v1/identities/{identityId}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 2 of 33 revisions.

- **2026-09-05** `abacf80da2fd` — 27 breaking, 3 warning, 5 info
- **2026-08-19** `70b5f74b1799` — 5 breaking, 48 warning, 75 info

## Changes

- **2026-09-05** `abacf80da2fd` — 27 breaking, 3 warning, 5 info
  - the `business/billingAddress/country` request property type changed from no type to `string`
  - the `business/incorporationCountryCode` request property type changed from no type to `string`
  - the `business/mailingAddress/country` request property type changed from no type to `string`
  - the `business/physicalBusinessAddress/country` request property type changed from no type to `string`
  - the `business/primaryOperationsCountryCode` request property type changed from no type to `string`
  - the `business/regulatorCountryCode` request property type changed from no type to `string`
  - the `individual/address/country` request property type changed from no type to `string`
  - the `individual/countryOfCitizenship` request property type changed from no type to `string`
  - the `individual/countryOfResidence` request property type changed from no type to `string`
  - the `individual/govIdCountryOfIssuance` request property type changed from no type to `string`
  - the `requestedProducts/items/country` request property type changed from no type to `string`
  - the `oneOf[subschema #1: IndividualIdentityResponse]/individual/address/country` response's property type changed from no type to `string` for status `200`
  - the `oneOf[subschema #1: IndividualIdentityResponse]/individual/countryOfCitizenship` response's property type changed from no type to `string` for status `200`
  - the `oneOf[subschema #1: IndividualIdentityResponse]/individual/countryOfResidence` response's property type changed from no type to `string` for status `200`
  - the `oneOf[subschema #1: IndividualIdentityResponse]/individual/govIdCountryOfIssuance` response's property type changed from no type to `string` for status `200`
  - the `oneOf[subschema #1: IndividualIdentityResponse]/requestedProducts/items/country` response's property type changed from no type to `string` for status `200`
  - the `oneOf[subschema #2: BusinessIdentityResponse]/associatedPeople/items/individual/address/country` response's property type changed from no type to `string` for status `200`
  - the `oneOf[subschema #2: BusinessIdentityResponse]/associatedPeople/items/individual/countryOfCitizenship` response's property type changed from no type to `string` for status `200`
  - the `oneOf[subschema #2: BusinessIdentityResponse]/associatedPeople/items/individual/countryOfResidence` response's property type changed from no type to `string` for status `200`
  - the `oneOf[subschema #2: BusinessIdentityResponse]/associatedPeople/items/individual/govIdCountryOfIssuance` response's property type changed from no type to `string` for status `200`
  - the `oneOf[subschema #2: BusinessIdentityResponse]/business/billingAddress/country` response's property type changed from no type to `string` for status `200`
  - the `oneOf[subschema #2: BusinessIdentityResponse]/business/incorporationCountryCode` response's property type changed from no type to `string` for status `200`
  - the `oneOf[subschema #2: BusinessIdentityResponse]/business/mailingAddress/country` response's property type changed from no type to `string` for status `200`
  - the `oneOf[subschema #2: BusinessIdentityResponse]/business/physicalBusinessAddress/country` response's property type changed from no type to `string` for status `200`
  - the `oneOf[subschema #2: BusinessIdentityResponse]/business/primaryOperationsCountryCode` response's property type changed from no type to `string` for status `200`
  - the `oneOf[subschema #2: BusinessIdentityResponse]/business/regulatorCountryCode` response's property type changed from no type to `string` for status `200`
  - the `oneOf[subschema #2: BusinessIdentityResponse]/requestedProducts/items/country` response's property type changed from no type to `string` for status `200`
  - added the new `financialCrimeComplianceQuestionnaire` enum value to the `oneOf[subschema #1: IndividualIdentityResponse]/documents/items/documentType` response property for the response status `200`
  - added the new `financialCrimeComplianceQuestionnaire` enum value to the `oneOf[subschema #2: BusinessIdentityResponse]/associatedPeople/items/documents/items/documentType` response property for the response status `200`
  - added the new `financialCrimeComplianceQuestionnaire` enum value to the `oneOf[subschema #2: BusinessIdentityResponse]/documents/items/documentType` response property for the response status `200`
  - added the new `financialCrimeComplianceQuestionnaire` enum value to the request property `documents/items/documentType`
  - added the non-success response with the status `429`
  - added the non-success response with the status `503`
  - added the optional property `details` to the response with the `500` status
  - added the required property `error` to the response with the `500` status
- **2026-08-19** `70b5f74b1799` — 5 breaking, 48 warning, 75 info
  - the response property `oneOf[subschema #1: IndividualIdentityResponse]/individual/address/subdivision` became optional for the status `200`
  - the response property `oneOf[subschema #2: BusinessIdentityResponse]/associatedPeople/items/individual/address/subdivision` became optional for the status `200`
  - the response property `oneOf[subschema #2: BusinessIdentityResponse]/business/billingAddress/subdivision` became optional for the status `200`
  - the response property `oneOf[subschema #2: BusinessIdentityResponse]/business/mailingAddress/subdivision` became optional for the status `200`
  - the response property `oneOf[subschema #2: BusinessIdentityResponse]/business/physicalBusinessAddress/subdivision` became optional for the status `200`
  - changed the pattern of the request property `business/tradeStrategy` from `^[A-Za-zÀ-ÿĀ-ſƀ-ɏ\s'\-\.,()"]+$` to `^[A-Za-zÀ-ÿĀ-ſƀ-ɏ0-9\s'\-\.,#\/( )&"]+$`
  - added the new `Link` enum value to the `oneOf[subschema #1: IndividualIdentityResponse]/requestedProducts/items/name` response property for the response status `200`
  - added the new `Link` enum value to the `oneOf[subschema #2: BusinessIdentityResponse]/requestedProducts/items/name` response property for the response status `200`
  - added the new `agreement` enum value to the `oneOf[subschema #1: IndividualIdentityResponse]/requirements/items/kind` response property for the response status `200`
  - added the new `agreement` enum value to the `oneOf[subschema #2: BusinessIdentityResponse]/associatedPeople/items/missingRequirements/items/kind` response property for the response status `200`
  - added the new `agreement` enum value to the `oneOf[subschema #2: BusinessIdentityResponse]/requirements/items/kind` response property for the response status `200`
  - added the new `authorizedSignerForm` enum value to the `oneOf[subschema #1: IndividualIdentityResponse]/documents/items/documentType` response property for the response status `200`
  - added the new `authorizedSignerForm` enum value to the `oneOf[subschema #2: BusinessIdentityResponse]/associatedPeople/items/documents/items/documentType` response property for the response status `200`
  - added the new `authorizedSignerForm` enum value to the `oneOf[subschema #2: BusinessIdentityResponse]/documents/items/documentType` response property for the response status `200`
  - added the new `bankStatement` enum value to the `oneOf[subschema #1: IndividualIdentityResponse]/individual/govIdClass` response property for the response status `200`
  - added the new `bankStatement` enum value to the `oneOf[subschema #2: BusinessIdentityResponse]/associatedPeople/items/individual/govIdClass` response property for the response status `200`
  - added the new `caseRequiredDocuments` enum value to the `oneOf[subschema #1: IndividualIdentityResponse]/documents/items/documentType` response property for the response status `200`
  - added the new `caseRequiredDocuments` enum value to the `oneOf[subschema #2: BusinessIdentityResponse]/associatedPeople/items/documents/items/documentType` response property for the response status `200`
  - added the new `caseRequiredDocuments` enum value to the `oneOf[subschema #2: BusinessIdentityResponse]/documents/items/documentType` response property for the response status `200`
  - added the new `certificateOfGoodStanding` enum value to the `oneOf[subschema #1: IndividualIdentityResponse]/documents/items/documentType` response property for the response status `200`
  - added the new `certificateOfGoodStanding` enum value to the `oneOf[subschema #2: BusinessIdentityResponse]/associatedPeople/items/documents/items/documentType` response property for the response status `200`
  - added the new `certificateOfGoodStanding` enum value to the `oneOf[subschema #2: BusinessIdentityResponse]/documents/items/documentType` response property for the response status `200`
  - added the new `computerizedPayslips` enum value to the `oneOf[subschema #1: IndividualIdentityResponse]/individual/govIdClass` response property for the response status `200`
  - added the new `computerizedPayslips` enum value to the `oneOf[subschema #2: BusinessIdentityResponse]/associatedPeople/items/individual/govIdClass` response property for the response status `200`
  - added the new `correspondentAccountCertification` enum value to the `oneOf[subschema #1: IndividualIdentityResponse]/documents/items/documentType` response property for the response status `200`
  - added the new `correspondentAccountCertification` enum value to the `oneOf[subschema #2: BusinessIdentityResponse]/associatedPeople/items/documents/items/documentType` response property for the response status `200`
  - added the new `correspondentAccountCertification` enum value to the `oneOf[subschema #2: BusinessIdentityResponse]/documents/items/documentType` response property for the response status `200`
  - added the new `dptHoldingStatement` enum value to the `oneOf[subschema #1: IndividualIdentityResponse]/individual/govIdClass` response property for the response status `200`
  - added the new `dptHoldingStatement` enum value to the `oneOf[subschema #2: BusinessIdentityResponse]/associatedPeople/items/individual/govIdClass` response property for the response status `200`
  - added the new `employmentLetterContract` enum value to the `oneOf[subschema #1: IndividualIdentityResponse]/individual/govIdClass` response property for the response status `200`
  - added the new `employmentLetterContract` enum value to the `oneOf[subschema #2: BusinessIdentityResponse]/associatedPeople/items/individual/govIdClass` response property for the response status `200`
  - added the new `externalVerification` enum value to the `oneOf[subschema #1: IndividualIdentityResponse]/requirements/items/kind` response property for the response status `200`
  - added the new `externalVerification` enum value to the `oneOf[subschema #2: BusinessIdentityResponse]/associatedPeople/items/missingRequirements/items/kind` response property for the response status `200`
  - added the new `externalVerification` enum value to the `oneOf[subschema #2: BusinessIdentityResponse]/requirements/items/kind` response property for the response status `200`
  - added the new `incomeTaxAssessment` enum value to the `oneOf[subschema #1: IndividualIdentityResponse]/individual/govIdClass` response property for the response status `200`
  - added the new `incomeTaxAssessment` enum value to the `oneOf[subschema #2: BusinessIdentityResponse]/associatedPeople/items/individual/govIdClass` response property for the response status `200`
  - added the new `investmentHoldingsStatement` enum value to the `oneOf[subschema #1: IndividualIdentityResponse]/individual/govIdClass` response property for the response status `200`
  - added the new `investmentHoldingsStatement` enum value to the `oneOf[subschema #2: BusinessIdentityResponse]/associatedPeople/items/individual/govIdClass` response property for the response status `200`
  - added the new `other` enum value to the `oneOf[subschema #1: IndividualIdentityResponse]/individual/govIdClass` response property for the response status `200`
  - added the new `other` enum value to the `oneOf[subschema #2: BusinessIdentityResponse]/associatedPeople/items/individual/govIdClass` response property for the response status `200`
  - …88 more

---

[Operation](https://skmtc.dev/bitgo/apis/bitgo-api/docs/api/identity-service/v1/identities/:identityId/patch.md) · [API](https://skmtc.dev/bitgo/apis/bitgo-api.md) · [Page](https://skmtc.dev/bitgo/apis/bitgo-api/changes/api/identity-service/v1/identities/:identityId/patch)