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
Header | Description |
---|---|
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. |
Parameter | Description |
department_id | The ID of the department you want to delete. |
Possible Response Codes
Code | Text | Description |
---|---|---|
204 | Successful operation | The requested department has been deleted. |
400 | Bad Request | A request error. |
401 | Unauthorized | An authorization error. |
403 | Permission 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
Sample Response
https/1.1 204 Successful operation Connection: close