API Reference
Log In
API Reference

Rename and/or reparent an org unit

Updates name when present. Moves the unit to parentId (null = root) only when reparent=true — this makes parentId:null unambiguous ("move to root" vs. "leave parent unchanged"). A payload with name omitted and reparent=false performs no mutation and returns the unit's current state (equivalent to a GET) rather than rejecting the request.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
int64
required

Org unit identifier

Query Params
string
required

Team (organization) identifier the unit belongs to

Body Params

Request to rename and/or reparent an org unit. name is applied whenever present. parentId is only applied as a reparent when reparent=true — this lets parentId: null unambiguously mean "move to root" rather than "leave parent unchanged".

string | null

New name; omit to leave the name unchanged

int64 | null

New parent org unit id; null moves the unit to root. Ignored unless reparent=true.

boolean
Defaults to false

Set true to apply parentId as a reparent operation

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
*/*