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

The password of Account Owner,Administrator, Department 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

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


Sample Response


https/1.1 204 No Content
XML