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
X-Auth-Account-Url (required)The base URL of the account, e.g. http://myaccount.ispringlearn.com
X-Auth-Email (required)The login of Account Owner,AdministratorDepartment Administrator, Publisher, or a user with a custom role.
X-Auth-Password (required)

The password of Account Owner,AdministratorDepartment Administrator, Publisher, or a user with a custom role.

ParameterDescription
department_idThe ID of the department you want to delete.



Possible Response Codes


Code

Text

Description

204Successful operation

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 HTTP/1.1
Host: api-learn.ispringlearn.com
X-Auth-Account-Url: https://myaccount.ispringlearn.com
X-Auth-Email: email@email.com
X-Auth-Password: password


Sample Response

HTTP/1.1 204 Successful operation
Connection: close