AVAILABLE WITH BUSINESS SUBSCRIPTION

Request: POST /user/{userId}/subordination

  • With this method, you can assign the supervisor and functional manager to a user.

  • Existing customers may continue using ispringlearn.com, and new customers should use ispring.com.

Permissions to Run the Request

Account Owner and Account Administrator, or a custom role that allows you to view, create, edit, and delete users.

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

Course authors do not have access to the methods or data involved in requesting user information.

Request Headers

Header

Description

Authorization (required)Access token. You can obtain a token by making a request.
userId (required)The ID of the user you are assigning a supervisor to.
ParameterDescription
subordination (required)An array with data on the type of supervisor subordination.
coSubordination (optional)An array with data on the type of functional manager subordination.
subordinationType (required)

The type of supervisor subordination.

  • inherit — Inherit from parent department.
  • manual — Assign manually.
  • no_supervisor — No supervisor.
supervisorId (optional)

The supervisor ID.

Specify the ID if subordinationType=manual.
If subordinationType=inherit, no_supervisor, there is no need to specify the supervisor ID.

Existing customers may continue using ispringlearn.com, and new customers should use ispring.com.

Response Codes

Code

Text

Description

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

Sample Request

POST /user/bc7ac85a-e911-11ea-9d4d-4a33a68eed9f/subordination
Host: api-learn.ispringlearn.com
Authorization: p-1sJDjmULL5DdpXPJTcbm4jVIaWVHvNmrjAxATRbNE
Content-Type:application/xml
 
<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