Update a group member's primary role and/or coach/director flags atomically

Single endpoint for the "Change Roles" modal. Applies a primary role change (LEADER, MEMBER, MAIN_LEADER, or NONE for removal) and/or coach/director column toggles in one transaction, recording history_groups rows for every transition (status_id 110 for coach, 120 for director). At least one of primary_role, is_coach, or is_director must be provided. is_coach/is_director are single-individual only.

Administrative-DB groups (interaction_type='d') skip history_groups writes for coach/director column changes — these synthetic groups don't keep individual involvement timelines, matching the legacy remove_director behavior in group_manage_list.php.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required

The group's id

Body Params
individual_ids
array of integers
required
length ≥ 1
individual_ids*
string
enum

LEADER/MEMBER update individual_groups.status_id; MAIN_LEADER promotes the individual to group owner; NONE removes the individual from individual_groups while leaving any coach_id/director_id column pointing at them intact (use with is_coach=false/is_director=false to clear those too).

Allowed:
boolean

Set or clear groups.coach_id (single-individual only)

boolean

Set or clear groups.director_id (single-individual only)

Responses
200

Roles updated successfully

400

Validation error (e.g. multi-individual leadership flag, no fields provided)

403

Caller lacks permission for the requested change

404

Group not found, or operation not valid for this group (e.g. system group removal)

Language
Credentials
OAuth2
Missing 1 required scope
LoadingLoading…
Response
Click Try It! to start a request and see the response here!