Update organizational unit
Partially updates mutable fields of an organizational unit.
Authorizations
Owner-typed API key (ORGANIZATION, PERSON, VALUE_UNIT). Manage org-scoped lifecycle with /v1/public-api-keys; cross-org governance is restricted to /v1/sys/public-api-keys.
Path Parameters
Body
Update payload. Resolve typeId first via GET /v1/public/organizational-units/types when changing type. Omit headId/deputyHeadId to keep current role assignments or send null to clear.
External identifier used by upstream systems. Omit to keep the current value. Send null to clear.
"hris-ou-1001"
Organizational unit type tag id. Resolve via GET /v1/public/tags/organizational-unit-types. Omit to keep current type.
"77f8a9e1-6131-4f74-9477-c3dd1f98d352"
Parent organizational unit id inside the authenticated organization. Omit to keep current parent.
"a5ec8a9e-b6a9-4230-9ce9-8db4bb40f6ff"
Head person id inside the authenticated organization. Omit to keep the current head. Send null to clear the head.
"2f6db7d4-6e6c-4d4f-90f2-cbaac8441f7b"
Deputy head person id inside the authenticated organization. Omit to keep the current deputy head. Send null to clear the deputy head.
"7b4f1a91-57cd-4a5e-b1f8-16b5705de95b"
Custom tags for the organizational unit. Omit to keep current tags or send an empty list to clear them.

