Sign in

v1

latestOpenAPI 3.1.02026-07-24181585937.4 KB
Department & Team

department.move

Moves a department to another parent.

Requires the organizationWrite permission.

post/department.move

Request body

departmentIdstring uuid required

The department's ID

parentIdstring uuid nullable

The department parent's ID. Pass null (or omit) to move to the top level.

Example request

{
  "departmentId": "1be42b8e-cafd-4beb-8121-f4981eb20f42",
  "parentId": "1be42b8e-cafd-4beb-8121-f4981eb20f42"
}

Response

Responses from the department.move endpoint

OR

Example response

{
  "success": true,
  "results": {
    "id": "3ae2b801-19f6-41ef-ad28-214bd731948f",
    "name": "Engineering Operations",
    "externalName": "Engineering",
    "isArchived": false,
    "parentId": null,
    "createdAt": "2024-01-01T00:00:00.000Z",
    "updatedAt": "2024-01-01T00:00:00.000Z",
    "extraData": null
  }
}