Versions Compared

Old Version 1

changes.mady.by.user Alina Levitskaya

Saved on

compared with

New Version Current

changes.mady.by.user Alina Levitskaya

Saved on

Key

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

...

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

info
Panel
bgColor#eaf4fd
iconfalse
  • The Account Owner and Account Administrator can assign themselves as user supervisors or functional managers.

  • Neither the Department Administrator nor a user with a custom role can assign themselves as a department supervisor.

Request Headers

Parameter

Type

Description

token (required)stringAccess token. You can obtain a token by making a request.
userId (required)stringThe ID of the user you are assigning a supervisor to.
subordination (optional)arrayAn array with data on the type of supervisor subordination.
coSubordination (optional)arrayAn array with data on the type of functional manager subordination.
subordinationType (required)string

The type of supervisor and functional manager subordination.

  • inherit — Inherit from parent department.
  • manual — Assign manually.
  • no_supervisor — No supervisor.
supervisorId (optional)stringThe supervisor and functional manager ID.Specify if subordinationType = manual.
-If subordinationType = inherit, no_supervisor, there is no need to specify the supervisor ID.

Return Value

After the request has been successfully processed, the system returns an object with the following properties:

Parameter

Type

Description

successboolTrue if the manager's subordination type has changed.

Possible Errors

TypeDescription
Permission DeniedThe user doesn't have enough permissions to get information on subordination.
Wrong parametersThe system failed to process the request because the parameter`s value is not specified or invalid.

Sample Request

Code Block
languagexml
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap="http://ispringlearn.com/go/services/api/soap">
   <soapenv:Body>
      <soap:ChangeUserSubordinationRequest>
         <soap:credentials>
            <soap:token>p-1sJDjmULL5DdpXPJTcbm4jVIaWVHvNmrjAxATRbNE</soap:token>
         </soap:credentials>
         <soap:userId>0ccca211-b60f-11ea-bc49-028d9ecdf612</soap:userId>
         <soap:subordination>
            <soap:subordinationType>manual</soap:subordinationType>
            <soap:supervisorId>ea100904-279b-11ed-82e7-0242ac160042</soap:supervisorId>
         </soap:subordination>
         <soap:coSubordination>
            <soap:subordinationType>inherit</soap:subordinationType>
         </soap:coSubordination>
      </soap:ChangeUserSubordinationRequest> 
   </soapenv:Body>
</soapenv:Envelope>

...