AVAILABLE WITH BUSINESS SUBSCRIPTION

Request: DELETE /department/{departmentId}

Permissions to Run the Request

Account Owner, Account Administrators, Department Administrators, or custom roles

Department Administrators, and users with a custom role can get information only on the department they manage and its enclosed departments.

You can't delete a department if:

  • it contains users,
  • it is managed by Department Administrator or Author,
  • it is the root one.


Request Headers

HeaderDescription
Authorization (required)Access token. You can obtain a token by making a request.
ParameterDescription
department_idThe ID of the department you want to delete.



Possible Response Codes


Code

Text

Description

204No Content

The requested department has been deleted.

400Bad RequestA request error.
401UnauthorizedAn authorization error.
403Permission Denied

The user doesn't have enough permissions to remove the department.


Sample Request


DELETE /department/be676588-5448-11e9-b7f7-62fb686e6fbe https/1.1
Host: api-learn.ispringlearn.com
Authorization: p-1sJDjmULL5DdpXPJTcbm4jVIaWVHvNmrjAxATRbNE
XML


Sample Response


https/1.1 204 No Content
XML