WOworkable

/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

Request

  • Base URL
    https://subdomain.workable.com/spi/v3
  • URL
    https://subdomain.workable.com/spi/v3/departments/{id}/merge
  • Auth
    API key in header Authorization

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"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.