Skip to main content
Answer

Delete Multiple Branches

  • February 23, 2024
  • 2 replies
  • 189 views
Jeremy.McKinley
Novice III
Forum|alt.badge.img+4

Hello all!

I’m looking to do some clean up of my branches.  I had preemptively created several branches with a mass upload for our client users.  After 3 years, I’m looking to remove any branches that are still empty.

  1. Is there a report or a way to quickly identify all branches without users?
  2. is there a way to do a mass delete of these empty branches?  Possibly including running an API

Thanks!

Best answer by elamast

Using your favorite automation tool, this will get you all of your branches and descendants:

https://YOURDOMAIN/manage/v1/orgchart?search_type=1&flattened=true

For each branch ID returned, you would want to retrieve the number of users:

https://YOURDOMAIN/manage/v1/orgchart/BRANCHNUMBER/users?page_size=1

The “page_size=1” parameter will return a single user (in order to limit the amount of data returned). The only part of the return you’re interested in is under the JSON path data.total_count

This will provide you with the number of users for that branch including subbranches.  You’re looking for that number to be zero.  At that point you could use the Batch deletion of branches endpoint to remove them this way:

https://YOURDOMAIN/manage/v1/orgchart/batch

{

  "items": [

    {

      "id": BRANCHNUMBER

    }

  ]

}

qtucker

2 replies

lrnlab
Hero III
Forum|alt.badge.img+10
  • lrnlab
  • Hero III
  • February 23, 2024

Not sure that a user report would should you the empty branches and since there is no real ‘branch report” it may still require some manual effort.

found this set if Apis but not sure it’s what you need:

https://doceboapi.docebosaas.com/api-browser/#!/report/BranchDashboardEnrollment/BranchDashboardEnrollment_report_v1_branch_dashboard_enrollment_id_view

Jeremy.McKinley
elamast
Hero I
Forum|alt.badge.img+7
  • elamast
  • Hero I
  • Answer
  • February 23, 2024

Using your favorite automation tool, this will get you all of your branches and descendants:

https://YOURDOMAIN/manage/v1/orgchart?search_type=1&flattened=true

For each branch ID returned, you would want to retrieve the number of users:

https://YOURDOMAIN/manage/v1/orgchart/BRANCHNUMBER/users?page_size=1

The “page_size=1” parameter will return a single user (in order to limit the amount of data returned). The only part of the return you’re interested in is under the JSON path data.total_count

This will provide you with the number of users for that branch including subbranches.  You’re looking for that number to be zero.  At that point you could use the Batch deletion of branches endpoint to remove them this way:

https://YOURDOMAIN/manage/v1/orgchart/batch

{

  "items": [

    {

      "id": BRANCHNUMBER

    }

  ]

}

Ed Lamaster, AVO Training Institute Learning Technologies Manager and consultant.
Jeremy.McKinley
Terms & ConditionsCookie settingsAccessibility statement