---
title: "Changes to Update a business"
method: PATCH
path: "/v1/businesses/{id}"
---

# Changes to Update a business

`PATCH /v1/businesses/{id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 13 of 15 revisions.

- **2026-10-25** `adc98c847a77`: 1 warning
- **2026-10-20** `a32370f9357e`: 2 warning, 2 info
- **2026-10-20** `410a449f7a40`: 11 breaking
- **2026-09-17** `4c9cd4e834ba`: 28 breaking, 1 warning, 29 info
- **2026-09-12** `668373c892ce`: 1 info
- **2026-09-03** `ac0d9be94846`: 1 breaking, 6 warning, 2 info
- **2026-08-22** `b496a7929e98`: 1 breaking, 2 warning, 5 info
- **2026-08-14** `015f33b27f13`: 2 info
- **2026-08-12** `f849b82a42e1`: 1 info
- **2026-08-06** `9882e52b445b`: 7 breaking, 53 info
- **2026-08-04** `771fb4da9502`: 2 info
- **2026-07-31** `d142de33085b`: 2 breaking, 7 info
- **2026-07-26** `83868e219c20`: 2 info

## Changes

- **2026-10-25** `adc98c847a77`: 1 warning
  - added the new `international_business_verification` enum value to the `orders/items/product` response property for the response status `200`
- **2026-10-20** `a32370f9357e`: 2 warning, 2 info
  - added the new `People NPI Match` enum value to the `review/oneOf[subschema #1: Review]/tasks/items/label` response property for the response status `200`
  - added the new `person_npi_match` enum value to the `review/oneOf[subschema #1: Review]/tasks/items/key` response property for the response status `200`
  - added the new optional request property `people/items/npi`
  - added the optional property `people/items/npi` to the response with the `200` status
- **2026-10-20** `410a449f7a40`: 11 breaking
  - the `addresses/items/latitude` response's property type changed from `number, null` to `string, null`, and format from `double` to no format for status `200`
  - the `addresses/items/longitude` response's property type changed from `number, null` to `string, null`, and format from `double` to no format for status `200`
  - the `adverse_media_screening/oneOf[subschema #1: AdverseMediaScreening]/exclusion_settings/criteria_match_threshold` response's property type changed from `number` to `string`, and format from `double` to no format for status `200`
  - the `adverse_media_screening/oneOf[subschema #1: AdverseMediaScreening]/results/items/match_score` response's property type changed from `number` to `string`, and format from `double` to no format for status `200`
  - the `adverse_media_screening/oneOf[subschema #1: AdverseMediaScreening]/results/items/risk_scores/additionalProperties/` response's property type changed from `number` to `string`, and format from `double` to no format for status `200`
  - the `industry_classification/oneOf[subschema #1: IndustryClassification]/categories/items/score` response's property type changed from `number` to `string`, and format from `double` to no format for status `200`
  - the `politically_exposed_person_screening/oneOf[subschema #1: PoliticallyExposedPersonScreening]/results/items/score` response's property type changed from `number` to `string`, and format from `double` to no format for status `200`
  - the `profiles/items/metadata/latitude` response's property type changed from `number` to `string`, and format from `double` to no format for status `200`
  - the `profiles/items/metadata/longitude` response's property type changed from `number` to `string`, and format from `double` to no format for status `200`
  - the `signal/oneOf[subschema #1: Signal]/reasons/items/importance` response's property type changed from `number` to `string`, and format from `double` to no format for status `200`
  - the `signal/oneOf[subschema #1: Signal]/score` response's property type changed from `number, null` to `string, null`, and format from `double` to no format for status `200`
- **2026-09-17** `4c9cd4e834ba`: 28 breaking, 1 warning, 29 info
  - removed `#/components/schemas/type_:SubmittedAddressFull, #/components/schemas/type_:SubmittedAddressComponent` from the `addresses/items/` request property `oneOf` list
  - added `#/components/schemas/AddressDeliverabilityAnalysis` to the `addresses/items/deliverability_analysis` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/AddressPropertyType` to the `addresses/items/property_type` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/AddressState` to the `addresses/items/state` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/AdverseMediaScreening` to the `adverse_media_screening` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/BusinessRisk` to the `risk` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/BusinessSubscriptionAvailability` to the `subscription_availability` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/Formation` to the `formation` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/IndustryClassification` to the `industry_classification` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/LienAlternativeDesignation` to the `liens/items/alternative_designation` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/LienAlternativeDesignation` to the `people/items/liens/items/alternative_designation` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/LienCollateralType` to the `liens/items/collateral_type` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/LienCollateralType` to the `people/items/liens/items/collateral_type` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/LoanDetails` to the `loans/items/details` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/Monitor` to the `monitor` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/NameType` to the `names/items/type` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/OrderRequesterType` to the `orders/items/requester/type` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/PoliticallyExposedPersonScreening` to the `politically_exposed_person_screening` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/RegistrationJurisdictionDetails` to the `registrations/items/jurisdiction_details` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/RegistrationState` to the `registrations/items/state` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/Requester` to the `requester` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/Review` to the `review` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/Signal` to the `signal` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/Subscription` to the `subscription` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/TaxExemptOrganization` to the `tax_exempt_organization` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/Tin` to the `tin` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/Watchlist` to the `watchlist` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/Website` to the `website` response property `oneOf` list for the response status `200`
  - deleted the `header` request parameter `Authorization`
  - the endpoint scheme security `bearer_auth` was added to the API
  - added `#/components/schemas/SubmittedAddressFull, #/components/schemas/SubmittedAddressComponent` to the `addresses/items/` request property `oneOf` list
  - removed `#/components/schemas/type_:AddressDeliverabilityAnalysis` from the `addresses/items/deliverability_analysis` response property `oneOf` list for the response status `200`
  - removed `#/components/schemas/type_:AddressPropertyType` from the `addresses/items/property_type` response property `oneOf` list for the response status `200`
  - removed `#/components/schemas/type_:AddressState` from the `addresses/items/state` response property `oneOf` list for the response status `200`
  - removed `#/components/schemas/type_:AdverseMediaScreening` from the `adverse_media_screening` response property `oneOf` list for the response status `200`
  - removed `#/components/schemas/type_:BusinessRisk` from the `risk` response property `oneOf` list for the response status `200`
  - removed `#/components/schemas/type_:BusinessSubscriptionAvailability` from the `subscription_availability` response property `oneOf` list for the response status `200`
  - removed `#/components/schemas/type_:Formation` from the `formation` response property `oneOf` list for the response status `200`
  - removed `#/components/schemas/type_:IndustryClassification` from the `industry_classification` response property `oneOf` list for the response status `200`
  - removed `#/components/schemas/type_:LienAlternativeDesignation` from the `liens/items/alternative_designation` response property `oneOf` list for the response status `200`
  - …18 more
- **2026-09-12** `668373c892ce`: 1 info
  - api operation id `updateBusiness` removed and replaced with `businesses_updateBusiness`
- **2026-09-03** `ac0d9be94846`: 1 breaking, 6 warning, 2 info
  - added the new required request property `addresses/items/oneOf[subschema #2: SubmittedAddressComponent]/address_line1`
  - removed the request property `addresses/items/oneOf[subschema #2: SubmittedAddressComponent]/address_line_1`
  - removed the request property `addresses/items/oneOf[subschema #2: SubmittedAddressComponent]/address_line_2`
  - added the new `failed` enum value to the `liens/items/status` response property for the response status `200`
  - added the new `failed` enum value to the `liens/items/status_category` response property for the response status `200`
  - added the new `failed` enum value to the `people/items/liens/items/status` response property for the response status `200`
  - added the new `failed` enum value to the `people/items/liens/items/status_category` response property for the response status `200`
  - added the new optional request property `addresses/items/oneOf[subschema #2: SubmittedAddressComponent]/address_line2`
  - added the optional property `errors/items/parameter` to the response with the `404` status
- **2026-08-22** `b496a7929e98`: 1 breaking, 2 warning, 5 info
  - added the pattern `^\d{5}(?:[-\s]\d{4})?$` to the request property `addresses/items/oneOf[subschema #2: SubmittedAddressComponent]/postal_code`
  - the `addresses/items/oneOf[subschema #1: SubmittedAddressFull]/reference` request property's maxLength was set to `64`
  - the `addresses/items/oneOf[subschema #2: SubmittedAddressComponent]/reference` request property's maxLength was set to `64`
  - the `addresses/items/postal_code` response's property pattern `^\d{5}(?:[-\s]\d{4})?$` was added for the status `200`
  - the `bankruptcies/items/business_id` response's property pattern `^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-4{1}[a-fA-F0-9]{3}-[89abAB]{1}[a-fA-F0-9]{3}-[a-fA-F0-9]{12}$` was added for the status `200`
  - the `bankruptcies/items/id` response's property pattern `^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-4{1}[a-fA-F0-9]{3}-[89abAB]{1}[a-fA-F0-9]{3}-[a-fA-F0-9]{12}$` was added for the status `200`
  - the `certifications/items/business_id` response's property pattern `^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-4{1}[a-fA-F0-9]{3}-[89abAB]{1}[a-fA-F0-9]{3}-[a-fA-F0-9]{12}$` was added for the status `200`
  - the `certifications/items/id` response's property pattern `^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-4{1}[a-fA-F0-9]{3}-[89abAB]{1}[a-fA-F0-9]{3}-[a-fA-F0-9]{12}$` was added for the status `200`
- **2026-08-14** `015f33b27f13`: 2 info
  - added the optional property `review/oneOf[subschema #1: Review]/analyst_read_generated_at` to the response with the `200` status
  - added the optional property `review/oneOf[subschema #1: Review]/analyst_read_markdown` to the response with the `200` status
- **2026-08-12** `f849b82a42e1`: 1 info
  - added the optional property `submitted/name_derived` to the response with the `200` status
- **2026-08-06** `9882e52b445b`: 7 breaking, 53 info
  - the response property `registrations/items/entity_type` became nullable for the status `200`
  - the response property `registrations/items/jurisdiction` became nullable for the status `200`
  - the response property `registrations/items/registered_agent` became nullable for the status `200`
  - the response property `registrations/items/registration_date` became nullable for the status `200`
  - the response property `registrations/items/source` became nullable for the status `200`
  - added `#/components/schemas/type_:RegistrationState, subschema #2` to the `registrations/items/state` response property `oneOf` list for the response status `200`
  - the `registrations/items/state` response's property type changed from `string` to no type for status `200`
  - added the optional property `registrations/items/country_code` to the response with the `200` status
  - added the optional property `registrations/items/jurisdiction_details` to the response with the `200` status
  - added the optional property `registrations/items/submitted` to the response with the `200` status
  - removed the `AK` enum value from the `registrations/items/state` response property for the response status `200`
  - removed the `AL` enum value from the `registrations/items/state` response property for the response status `200`
  - removed the `AR` enum value from the `registrations/items/state` response property for the response status `200`
  - removed the `AZ` enum value from the `registrations/items/state` response property for the response status `200`
  - removed the `CA` enum value from the `registrations/items/state` response property for the response status `200`
  - removed the `CO` enum value from the `registrations/items/state` response property for the response status `200`
  - removed the `CT` enum value from the `registrations/items/state` response property for the response status `200`
  - removed the `DE` enum value from the `registrations/items/state` response property for the response status `200`
  - removed the `FL` enum value from the `registrations/items/state` response property for the response status `200`
  - removed the `GA` enum value from the `registrations/items/state` response property for the response status `200`
  - removed the `HI` enum value from the `registrations/items/state` response property for the response status `200`
  - removed the `IA` enum value from the `registrations/items/state` response property for the response status `200`
  - removed the `ID` enum value from the `registrations/items/state` response property for the response status `200`
  - removed the `IL` enum value from the `registrations/items/state` response property for the response status `200`
  - removed the `IN` enum value from the `registrations/items/state` response property for the response status `200`
  - removed the `KS` enum value from the `registrations/items/state` response property for the response status `200`
  - removed the `KY` enum value from the `registrations/items/state` response property for the response status `200`
  - removed the `LA` enum value from the `registrations/items/state` response property for the response status `200`
  - removed the `MA` enum value from the `registrations/items/state` response property for the response status `200`
  - removed the `MD` enum value from the `registrations/items/state` response property for the response status `200`
  - removed the `ME` enum value from the `registrations/items/state` response property for the response status `200`
  - removed the `MI` enum value from the `registrations/items/state` response property for the response status `200`
  - removed the `MN` enum value from the `registrations/items/state` response property for the response status `200`
  - removed the `MO` enum value from the `registrations/items/state` response property for the response status `200`
  - removed the `MS` enum value from the `registrations/items/state` response property for the response status `200`
  - removed the `MT` enum value from the `registrations/items/state` response property for the response status `200`
  - removed the `NC` enum value from the `registrations/items/state` response property for the response status `200`
  - removed the `ND` enum value from the `registrations/items/state` response property for the response status `200`
  - removed the `NE` enum value from the `registrations/items/state` response property for the response status `200`
  - removed the `NH` enum value from the `registrations/items/state` response property for the response status `200`
  - …20 more
- **2026-08-04** `771fb4da9502`: 2 info
  - added the new optional request property `phone_numbers`
  - added the new optional request property `website`
- **2026-07-31** `d142de33085b`: 2 breaking, 7 info
  - the response property `risk/oneOf[subschema #1: BusinessRisk]/latest_assessment_id` became optional for the status `200`
  - the response property `risk/oneOf[subschema #1: BusinessRisk]/level` became optional for the status `200`
  - added the new optional request property `addresses/items/oneOf[subschema #1: SubmittedAddressFull]/reference`
  - added the new optional request property `addresses/items/oneOf[subschema #2: SubmittedAddressComponent]/reference`
  - added the optional property `addresses/items/references` to the response with the `200` status
  - added the optional property `industry_classification/oneOf[subschema #1: IndustryClassification]/categories/items/risk_program_flags` to the response with the `200` status
  - added the optional property `risk/oneOf[subschema #1: BusinessRisk]/reason` to the response with the `200` status
  - added the optional property `risk/oneOf[subschema #1: BusinessRisk]/score` to the response with the `200` status
  - added the required property `risk/oneOf[subschema #1: BusinessRisk]/status` to the response with the `200` status
- **2026-07-26** `83868e219c20`: 2 info
  - added the optional property `phone_numbers/items/id` to the response with the `200` status
  - added the optional property `risk` to the response with the `200` status

---

[Operation](https://skmtc.dev/middesk/apis/middesk-api/docs/v1/businesses/:id/patch.md) - [API](https://skmtc.dev/middesk/apis/middesk-api.md) - [Page](https://skmtc.dev/middesk/apis/middesk-api/changes/v1/businesses/:id/patch)
