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

put

https://api.ccbchurch.com/groups/{group_id}/members/roles

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

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

group_id

integer

required

The group's id

Body Params

individual_ids

array of integers

required

length ≥ 1

individual_ids*

primary_role

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:

is_coach

boolean

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

is_director

boolean

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

previous_main_leader_role

string

enum

Only valid alongside primary_role=MAIN_LEADER. Reassigns the outgoing main leader (the group's current owner) to this role once the new main leader is promoted. NONE removes the outgoing leader from the group. When omitted, the outgoing leader keeps their existing leader status.

Allowed:

previous_main_leader_is_coach

boolean

Set or clear groups.coach_id for the outgoing main leader (only valid alongside primary_role=MAIN_LEADER). Cannot be combined with is_coach in the same request — both target the same column for two different individuals.

previous_main_leader_is_director

boolean

Set or clear groups.director_id for the outgoing main leader (only valid alongside primary_role=MAIN_LEADER). Cannot be combined with is_director in the same request — both target the same column for two different individuals.

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

Loading…

Response

Click Try It! to start a request and see the response here!