Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Table of Contents
maxLevel2
minLevel2
excludeRequest: POST /department/{departmentId}/subordination

info
Panel
bgColor#eaf4fd
With this method, you can assign the supervisor and functional manager for the department.

...

Department Administrator and a user with a role with individual settings can only assign a manager to departments that they manage.

info
Panel
bgColor
#eaf4fd
iconfalse
  • 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.
ParameterDescription
subordination (optional)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.

  • inherit — Inherit from parent department.
  • manual — Assign manually.
  • no_supervisor — No supervisor.
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

204No ContentThe supervisor is assigned to the department.
400Bad RequestA request error.
401UnauthorizedAn authorization error.
403Permission DeniedThe user doesn't have enough permissions to get information on subordination.

Sample Request

Code Block
languagexml
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> 

...