Company Structure in REST 3.0: Overview of Sections

The company structure illustrates the departments that make up the organization and how they are interconnected. Each department and team can define the roles of participants: leader, deputy, and staff members. This helps maintain an up-to-date organizational chart, quickly locate the necessary department or employee, configure collaborative work, and utilize the structure in related Bitrix24 tools.

The methods in this section work with two groups of objects:

• Departments and Teams — create departments and teams, retrieve their lists, data, child elements, and field descriptions.
• Department and Team Members — add users, assign roles, transfer, and remove participants.

Quick navigation: all methods

User documentation: Company structure: New interface and features

Getting StartedGetting Started

1. Retrieve the list of departments or teams via humanresources.node.list to identify the required id.
2. Check the data of a department or team through humanresources.node.get if the identifier is already known.
3. Create a new department or team via humanresources.node.add or modify their properties through humanresources.node.edit.
4. Obtain user identifiers using the user.get method if you need to prepare the list of participants.
5. Add participants via humanresources.node.member.add or set the complete composition through humanresources.node.member.set.

Limitations and RecommendationsLimitations and Recommendations

• Access to view and modify the company structure depends on the current user's permissions.
• Different sets of participant roles are used for departments and teams.
• Use field description methods to check available fields and their types before modifying data.

Connection with Other ObjectsConnection with Other Objects

Users. To add, transfer, and remove participants, user identifiers userIds are required. These can be obtained using the user.get method.

Chats, Channels, and Collabs. When creating a department or team, the humanresources.node.add method allows you to create or link related chats, channels, and collabs immediately.

Overview of MethodsOverview of Methods

Scope: humanresources

Who can execute methods: depends on the method

Departments and TeamsDepartments and Teams

Method	Description
humanresources.node.add	Creates a department or team
humanresources.node.edit	Updates fields of a department or team
humanresources.node.get	Returns a department or team by identifier
humanresources.node.list	Returns a list of departments and teams
humanresources.node.search	Searches for departments and teams by name
humanresources.node.children	Returns child departments and teams
humanresources.node.count	Returns the number of departments and teams
humanresources.node.move	Moves a department or team to a new parent
humanresources.node.field.list	Returns a list of fields for a department or team
humanresources.node.field.get	Returns the description of a field for a department or team

Department and Team MembersDepartment and Team Members

Method	Description
humanresources.node.member.add	Adds users to a department or team
humanresources.node.member.set	Updates the composition of department or team members 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 LearningContinue Learning

• Departments and Teams: Overview of Methods
• Participants of Departments and Teams: Overview of Methods
• Overview of REST API 3.0