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 |
|---|---|
| Authorization (required) | Access token. You can obtain a token by making a request. |
| Parameter | Description |
| department_id | The ID of the department you want to delete. |
Possible Response Codes
Code | Text | Description |
|---|---|---|
| 204 | No Content | 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 Authorization: p-1sJDjmULL5DdpXPJTcbm4jVIaWVHvNmrjAxATRbNE
Sample Response
https/1.1 204 No Content