Participants of Departments and Teams: Overview of Methods

Participants of departments and teams define who belongs to a department or team and what role they occupy within the company structure. The methods humanresources.node.member.* assist in adding users, assigning roles, transferring participants between departments and teams, and removing them.

Quick navigation: all methods

User documentation: Company structure: New interface and features

Working with ParticipantsWorking with Participants

1. Identify the required department or team and obtain the nodeId using the humanresources.node.list method. If the identifier is already known, verify the department or team data using the humanresources.node.get method.
2. Retrieve user identifiers using the user.get method if you need to prepare userIds for adding, transferring, or removing participants.
3. Add users to the desired department or team using the humanresources.node.member.add method.
4. Use humanresources.node.member.set if you need to specify the complete composition of participants by roles in a single request.
5. Transfer participants to another department or team using the humanresources.node.member.move method if you need to change their position in the structure.
6. Remove participants using the humanresources.node.member.remove method if they should no longer belong to the department or team.

Section LimitationsSection Limitations

• Access to view and modify participants depends on the permissions of the current user.
• The humanresources.node.member.add method assigns a single role for all users from userIds.

Connection with Other ObjectsConnection with Other Objects

Departments and Teams. All methods in this section use nodeId — the identifier of the department or team for which the composition of participants is being changed. The nodeId is obtained using the humanresources.node.list method. The department or team data can be verified using the humanresources.node.get method. To work with the hierarchy of departments and teams, use the methods in the humanresources.node.* section.

Users. To add, transfer, and remove participants, userIds — user identifiers — are used. These can be obtained using the user.get method. In the humanresources.node.member.add method, userIds are passed as a single list, while in humanresources.node.member.set, they are provided as an object with lists by roles.

Participant Roles. A role defines a user's position in a department or team: leader, deputy, or employee. Role codes are passed in the role parameter of the humanresources.node.member.add method and in the keys of the userIds object in the humanresources.node.member.set method.

Overview of MethodsOverview of Methods

Scope: humanresources

Who can execute the method: depends on the method

Method	Description
humanresources.node.member.add	Adds users to a department or team
humanresources.node.member.set	Updates the composition of participants in a department or team by roles
humanresources.node.member.move	Transfers users to another department or team
humanresources.node.member.remove	Removes users from a department or team

Continue Your ExplorationContinue Your Exploration

• Departments and Teams: Overview of Methods
• Company Structure in REST 3.0: Overview of Sections