---
title: "Update an organization in the application via patch"
method: PATCH
path: "/organizations/{organizationId}"
---

# Update an organization in the application via patch

`PATCH /organizations/{organizationId}`

## Path parameters

- `organizationId` string, required

## Query parameters

- `api-version` string, required

## Headers

- `If-Match` string

## Request body

- object

## Response `200`

Success

- Organization — The organization definition.
  - `id` string — Unique ID of the organization.
  - `displayName` string — Display name of the organization.
  - `parent` string — ID of the parent of the organization.

## Other responses

- `default` — An error response received from the IoT Central Service.

## Changes

- **2026-07-13** (1.0) `565d8813cbd3` — 1 info
  - added the new optional `header` request parameter `If-Match`
- **2026-07-13** (1.0) `50c39d38d85a` — 1 breaking
  - api path removed without deprecation
- **2026-07-13** (1.0) `5705f777edf6` — 1 info
  - endpoint added
- **2026-07-13** (1.0) `91b0e78f975b` — 1 breaking
  - api path removed without deprecation
- **2026-07-13** (1.0) `6626576352d6` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/azure/apis/iotcentral-iotcentral/changes/organizations/:organizationId/patch.md)

---

[API](https://skmtc.dev/azure/apis/iotcentral-iotcentral.md) · [All operations](https://skmtc.dev/azure/apis/iotcentral-iotcentral/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/iotcentral-iotcentral/revisions/565d8813cbd3/schema)