Update a Group - Virtuous API Docs

curl --request PUT \ --url https://api.vomo.org/v1/groups/{id} \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "name": "Morning Crew", "description": "A group for the morning crew to organize", "member_moniker": "Member", "subgroup_moniker": "Subgroup", "created_by_user_id": "1", "parent_id": "1", "members": [ "1" ] } '

{ "data": { "id": 604, "name": "Weekend Warriors — Updated", "description": "Volunteers available on weekends for any project.", "parent_id": null, "has_subgroups": false, "created_at": "2025-11-21T09:00:00+00:00", "updated_at": "2025-11-22T11:00:00+00:00" } }

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

integer

required

VOMO Group ID

Body

application/json

Group fields to update

Request body for creating or updating a group.

name

string

required

The name of the group

Example:

"Morning Crew"

description

string | null

A description for the group

Example:

"A group for the morning crew to organize"

member_moniker

string

A word describing a group member

Example:

"Member"

subgroup_moniker

string

A word describing subgroups

Example:

"Subgroup"

created_by_user_id

integer

Optional. If provided, must be an existing user who is a member of the organization.

Example:

"1"

parent_id

integer

The VOMO Group ID to set as the parent group of the newly created group

Example:

"1"

members

integer[]

User IDs to set as the group's membership. On create (POST), these become the initial members. On update (PUT), this replaces the existing membership — any current member omitted from the array is removed from the group. Pass an empty array to clear all members.

Response

Returns the updated group record with all current field values.

data

object

List of Groups

Show child attributes