Assigning a Department Supervisor Role
AVAILABLE WITH BUSINESS SUBSCRIPTION
Request: POST /department/{departmentId}/subordination
With this method, you can assign the supervisor and functional manager for the department.
Permissions to Run the Request
Account Owner and Account Administrator, or a custom role that allows you to view, create, edit, and delete departments.
Department Administrator and a user with a role with individual settings can only assign a manager to departments that they manage.
- The Account Owner and Account Administrator can assign themselves as department supervisors or functional managers.
- Neither the Department Administrator nor a user with a custom role can assign themselves as a department supervisor.
Request Headers
Header | Description | |
---|---|---|
Authorization (required) | Access token. You can obtain a token by making a request. | |
departmentId (required) | The ID of the department you are assigning a supervisor for. | |
Parameter | Description | |
subordination (required) | An array with data on the type of department supervisor subordination. | |
coSubordination (optional) | An array with data on the type of functional manager subordination. | |
subordinationType (required) | The type of supervisor and functional manager subordination.
| |
supervisorId (optional) | The supervisor and functional manager ID. | Specify if subordinationType = manual. |
- | If subordinationType = inherit, no_supervisor, there is no need to specify the supervisor ID. |
Response Codes
Code | Text | Description |
---|---|---|
204 | No Content | The supervisor is assigned to the department. |
400 | Bad Request | A request error. |
401 | Unauthorized | An authorization error. |
403 | Permission Denied | The user doesn't have enough permissions to get information on subordination. |
Sample Request
POST /department/{departmentId}/subordination
Host: api-learn.ispringlearn.com
Authorization: p-1sJDjmULL5DdpXPJTcbm4jVIaWVHvNmrjAxATRbNE
Content-Type:application/xml
<?xml version="1.0" encoding="UTF-8"?>
<request>
<subordination>
<subordinationType>manual</subordinationType>
<supervisorId>0ccca211-b60f-11ea-bc49-028d9ecdf612</supervisorId>
</subordination>
<coSubordination>
<subordinationType>no_supervisor</subordinationType>
</coSubordination>
</request>
XML
Sample Response
https/1.1 204 No Content
XML