Participants of Groups and Projects: Overview of Methods

Participants of groups and projects are users who are part of working groups and projects. They can have different roles and permissions.

Quick navigation: all methods

User documentation: Frequently Asked Questions about Groups and Projects in Bitrix24

Connection of Participants in Working Groups and Projects with Other ObjectsConnection of Participants in Working Groups and Projects with Other Objects

Users. They are part of workgroups and projects. To retrieve a user ID, use the user.get method.

Groups and Projects. To retrieve the ID of a group or project, use the sonet_group.get method. You can retrieve the list of group participants using sonet_group.user.get.

Group Participant Roles. Participants in workgroups and projects can have different roles: administrator, moderator, participant. Access permissions depend on these roles. To change a participant's role, use the sonet_group.user.update method.

Tasks. Participants of groups and projects can be assigned as task assignees. When creating a task, add participants using the tasks.task.add method. Specify the parameters CREATED_BY — task creator, RESPONSIBLE_ID — primary assignee, ACCOMPLICES — participants, AUDITORS — observers. When updating a task, you can add participants using the tasks.task.update method. To do this, pass the updated RESPONSIBLE_ID, ACCOMPLICES, and AUDITORS parameters.

How to Get StartedHow to Get Started

1. Retrieve the user ID using the user.get method.
2. Retrieve the group or project ID using the sonet_group.get or socialnetwork.api.workgroup.list method.
3. Add a participant using the sonet_group.user.add method or send an invitation using the sonet_group.user.invite method.
4. Check the participant list using the sonet_group.user.get method.
5. If needed, change the participant's role using the sonet_group.user.update method.

Overview of MethodsOverview of Methods

Scope: sonet

Who can execute the methods: any user

Method	Description
sonet_group.user.add	Adds a participant to the working group
sonet_group.user.invite	Invites a participant to the group
sonet_group.user.request	Sends a request to join the group
sonet_group.user.delete	Removes a participant from the group
sonet_group.user.get	Retrieves the list of participants in the group
sonet_group.user.update	Changes a participant's role in the group