---
title: "Update a business entity"
method: PUT
path: "/v1/organization/business_entities/{id}"
tags: ["Organization management"]
---

# Update a business entity

`PUT /v1/organization/business_entities/{id}`

This endpoint updates the details of a specified business entity in the system.

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `name` string, required — The new name of the business entity.
  - `description` string — The new description of the business entity.

## Response `200`

Business entity successfully updated

- BusinessEntity
  - `id` string, uuid, required
  - `orgID` string, uuid
  - `parentID` string, uuid, nullable
  - `name` string, required — The name of the business entity
  - `description` string — A description of the business entity
  - `countryCode` string — The country code of the business entity.
  - `subIndustryCode` string, nullable — The sub-industry code of the business entity or functional unit, formatted as eight digits.
  - `facilityTypeID` string, uuid, nullable — The facility type of the business entity if it is a facility.
  - `processTypeID` string, uuid, nullable — The process type of the business entity if it is a process.
  - `businessEntityTypeID` string, uuid
  - `defaultFunctionalUnitID` string, uuid
  - `defaultDisplayUnit` string — The default display unit for the functional unit of the business entity
  - `activeStartTimestamp` number — The timestamp when the business entity becomes active, in milliseconds since epoch
  - `activeEndTimestamp` number — The timestamp when the business entity becomes inactive, in milliseconds since epoch

---

[API](https://skmtc.net/sinai/apis/sinai-api.md) · [All operations](https://skmtc.net/sinai/apis/sinai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sinai/sinai-api/revisions/495dab1b31fd/schema)