v1

latestOpenAPI 3.1.02026-07-14801408.6 KB

/departments/:id/merge

Merges an existing department with a target one in your account. Required scope: w_departments. Accessible with all token types.

post/departments/{id}/merge

Path parameters

subdomainstring required

The account subdomain

idstring required

The department id that you want to merge with a target department

Request body

target_department_idstring required

The target department identifier that we want the given department id to be merged with

forceboolean

When false then first will make a check to see if there are any affected resources with this action and then will return error with the affected resources, if any were found. When true then will bypass those affected resources and will proceed to the merge anyway

Response

200

idstring

namestring

parent_idstring

sampleboolean

Example response

{
  "id": "3ff4d64b",
  "name": "HR"
}