---
title: "Changes to Update an Entity"
method: PATCH
path: "/entities/{entity_id}"
---

# Changes to Update an Entity

`PATCH /entities/{entity_id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 15 of 98 revisions.

- **2026-09-24** `60063efd9429`: 1 warning, 1 info
- **2026-09-18** `17aa1bcd9fae`: 6 warning
- **2026-09-16** `87f179eb7676`: 5 info
- **2026-09-04** `e73761b43130`: 1 info
- **2026-09-04** `df12904e8966`: 1 info
- **2026-08-27** `e5c4bdef77c4`: 1 warning, 1 info
- **2026-08-08** `e968bcd4dcf9`: 1 info
- **2026-08-08** `c6111f49e8b7`: 1 warning, 2 info
- **2026-07-31** `1d5927a18115`: 1 breaking
- **2026-07-26** `df2b1ead4c49`: 6 info
- **2026-07-13** `64a92a8cc343`: 6 breaking, 6 info
- **2026-04-20** `1f2c653a8b55`: 1 info
- **2026-04-13** `ec147e2dbccc`: 1 info
- **2026-04-12** `e1702c4a3b65`: 15 breaking, 5 info
- **2026-04-11** `ff1d99efd9ee`: 2 info

## Changes

- **2026-09-24** `60063efd9429`: 1 warning, 1 info
  - added the new `beneficial_owner_tax_identifier` enum value to the `validation/anyOf[subschema #1: Entity EntityValidation]/issues/items/category` response property for the response status `200`
  - added the required property `validation/anyOf[subschema #1: Entity EntityValidation]/issues/items/beneficial_owner_tax_identifier` to the response with the `200` status
- **2026-09-18** `17aa1bcd9fae`: 6 warning
  - added the new `social_security_number_last4` enum value to the `corporation/anyOf[subschema #1: Entity Corporation]/beneficial_owners/items/individual/identification/anyOf[subschema #1: Entity Corporation Beneficial Owner Reference Individual Identification]/method` response property for the response status `200`
  - added the new `social_security_number_last4` enum value to the `joint/anyOf[subschema #1: Entity Joint]/individuals/items/identification/anyOf[subschema #1: Entity Joint Individual Identification]/method` response property for the response status `200`
  - added the new `social_security_number_last4` enum value to the `natural_person/anyOf[subschema #1: Entity Individual]/identification/anyOf[subschema #1: Entity Individual Identification]/method` response property for the response status `200`
  - added the new `social_security_number_last4` enum value to the `sole_proprietorship/anyOf[subschema #1: Entity SoleProprietorship]/sole_proprietor/identification/anyOf[subschema #1: Entity SoleProprietorship Individual Identification]/method` response property for the response status `200`
  - added the new `social_security_number_last4` enum value to the `trust/anyOf[subschema #1: Entity Trust]/grantor/anyOf[subschema #1: Entity Trust Trust Grantor]/identification/anyOf[subschema #1: Entity Trust Trust Grantor Identification]/method` response property for the response status `200`
  - added the new `social_security_number_last4` enum value to the `trust/anyOf[subschema #1: Entity Trust]/trustees/items/individual/anyOf[subschema #1: Entity Trust TrusteesElement Individual]/identification/anyOf[subschema #1: Entity Trust TrusteesElement Individual Identification]/method` response property for the response status `200`
- **2026-09-16** `87f179eb7676`: 5 info
  - added the new required request property `trust/address/country` with a default value
  - the request property `trust/address/state` became optional
  - the request property `trust/address/zip` became optional
  - the `trust/address/state` request property's maxLength was increased from `2` to `200`
  - the `trust/address/state` request property's minLength was decreased from `2` to `1`
- **2026-09-04** `e73761b43130`: 1 info
  - added the new optional request property `sole_proprietorship/industry_code`
- **2026-09-04** `df12904e8966`: 1 info
  - added the new optional request property `sole_proprietorship`
- **2026-08-27** `e5c4bdef77c4`: 1 warning, 1 info
  - added the new `sole_proprietorship` enum value to the `structure` response property for the response status `200`
  - added the required property `sole_proprietorship` to the response with the `200` status
- **2026-08-08** `e968bcd4dcf9`: 1 info
  - added the new optional request property `trust/grantor`
- **2026-08-08** `c6111f49e8b7`: 1 warning, 2 info
  - added the new `entity_identity` enum value to the `validation/anyOf[subschema #1: Entity EntityValidation]/issues/items/category` response property for the response status `200`
  - added the new optional request property `trust/trustees`
  - added the required property `validation/anyOf[subschema #1: Entity EntityValidation]/issues/items/entity_identity` to the response with the `200` status
- **2026-07-31** `1d5927a18115`: 1 breaking
  - response property `terms_agreements/items/ip_address` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
- **2026-07-26** `df2b1ead4c49`: 6 info
  - the `category` request property default value `us_employer_identification_number` was added
  - the `country` request property default value `US` was added
  - the `country` request property default value `US` was added
  - the `method` request property default value `social_security_number` was added
  - added `subschema #1: Entity Trust Trust Grantor` to the `trust/anyOf[subschema #1: Entity Trust]/grantor` response property `anyOf` list for the response status `200`
  - removed `subschema #1: Entity Trust Individual` from the `trust/anyOf[subschema #1: Entity Trust]/grantor` response property `anyOf` list for the response status `200`
- **2026-07-13** `64a92a8cc343`: 6 breaking, 6 info
  - the `government_authority/address/state` request property's maxLength was decreased to `2`
  - the `natural_person/identification/drivers_license/state` request property's maxLength was decreased to `2`
  - the `trust/address/state` request property's maxLength was decreased to `2`
  - the `government_authority/address/state` request property's minLength was increased from `1` to `2`
  - the `natural_person/identification/drivers_license/state` request property's minLength was increased from `1` to `2`
  - the `trust/address/state` request property's minLength was increased from `1` to `2`
  - added the new optional request property `corporation/website`
  - added `subschema #8, subschema #10` to the `allOf[#/components/schemas/error]/` response property `anyOf` list for the response status `4XX`
  - added `subschema #8, subschema #10` to the `allOf[#/components/schemas/error]/` response property `anyOf` list for the response status `5XX`
  - removed `subschema #8, subschema #10` from the `allOf[#/components/schemas/error]/` response property `anyOf` list for the response status `4XX`
  - removed `subschema #8, subschema #10` from the `allOf[#/components/schemas/error]/` response property `anyOf` list for the response status `5XX`
  - added the required property `corporation/anyOf[subschema #1: Entity Corporation]/beneficial_ownership_exemption_reason` to the response with the `200` status
- **2026-04-20** `1f2c653a8b55`: 1 info
  - added the new optional request property `terms_agreements`
- **2026-04-13** `ec147e2dbccc`: 1 info
  - added the required property `creating_entity_onboarding_session_id` to the response with the `200` status
- **2026-04-12** `e1702c4a3b65`: 15 breaking, 5 info
  - the `corporation/anyOf[subschema #1: Entity Corporation]/beneficial_owners/items/individual/identification` response's property type changed from `object` to no type for status `200`
  - the `joint/anyOf[subschema #1: Entity Joint]/individuals/items/identification` response's property type changed from `object` to no type for status `200`
  - the `natural_person/anyOf[subschema #1: Entity Individual]/identification` response's property type changed from `object` to no type for status `200`
  - the `trust/anyOf[subschema #1: Entity Trust]/grantor/anyOf[subschema #1: Entity Trust Individual]/identification` response's property type changed from `object` to no type for status `200`
  - the `trust/anyOf[subschema #1: Entity Trust]/trustees/items/individual/anyOf[subschema #1: Entity Trust TrusteesElement Individual]/identification` response's property type changed from `object` to no type for status `200`
  - removed the required property `corporation/anyOf[subschema #1: Entity Corporation]/beneficial_owners/items/individual/identification/method` from the response with the `200` status
  - removed the required property `corporation/anyOf[subschema #1: Entity Corporation]/beneficial_owners/items/individual/identification/number_last4` from the response with the `200` status
  - removed the required property `joint/anyOf[subschema #1: Entity Joint]/individuals/items/identification/method` from the response with the `200` status
  - removed the required property `joint/anyOf[subschema #1: Entity Joint]/individuals/items/identification/number_last4` from the response with the `200` status
  - removed the required property `natural_person/anyOf[subschema #1: Entity Individual]/identification/method` from the response with the `200` status
  - removed the required property `natural_person/anyOf[subschema #1: Entity Individual]/identification/number_last4` from the response with the `200` status
  - removed the required property `trust/anyOf[subschema #1: Entity Trust]/grantor/anyOf[subschema #1: Entity Trust Individual]/identification/method` from the response with the `200` status
  - removed the required property `trust/anyOf[subschema #1: Entity Trust]/grantor/anyOf[subschema #1: Entity Trust Individual]/identification/number_last4` from the response with the `200` status
  - removed the required property `trust/anyOf[subschema #1: Entity Trust]/trustees/items/individual/anyOf[subschema #1: Entity Trust TrusteesElement Individual]/identification/method` from the response with the `200` status
  - removed the required property `trust/anyOf[subschema #1: Entity Trust]/trustees/items/individual/anyOf[subschema #1: Entity Trust TrusteesElement Individual]/identification/number_last4` from the response with the `200` status
  - added `subschema #1: Entity Corporation Beneficial Owner Reference Individual Identification, subschema #2` to the `corporation/anyOf[subschema #1: Entity Corporation]/beneficial_owners/items/individual/identification` response property `anyOf` list for the response status `200`
  - added `subschema #1: Entity Individual Identification, subschema #2` to the `natural_person/anyOf[subschema #1: Entity Individual]/identification` response property `anyOf` list for the response status `200`
  - added `subschema #1: Entity Joint Individual Identification, subschema #2` to the `joint/anyOf[subschema #1: Entity Joint]/individuals/items/identification` response property `anyOf` list for the response status `200`
  - added `subschema #1: Entity Trust Individual Identification, subschema #2` to the `trust/anyOf[subschema #1: Entity Trust]/grantor/anyOf[subschema #1: Entity Trust Individual]/identification` response property `anyOf` list for the response status `200`
  - added `subschema #1: Entity Trust TrusteesElement Individual Identification, subschema #2` to the `trust/anyOf[subschema #1: Entity Trust]/trustees/items/individual/anyOf[subschema #1: Entity Trust TrusteesElement Individual]/identification` response property `anyOf` list for the response status `200`
- **2026-04-11** `ff1d99efd9ee`: 2 info
  - added the new optional request property `natural_person/confirmed_no_us_tax_id`
  - added the new optional request property `natural_person/identification`

---

[Operation](https://skmtc.dev/increase/apis/increase-api-2/docs/entities/:entity_id/patch.md) - [API](https://skmtc.dev/increase/apis/increase-api-2.md) - [Page](https://skmtc.dev/increase/apis/increase-api-2/changes/entities/:entity_id/patch)
