---
title: "Update an existing user group"
method: PATCH
path: "/v4/queue-user-group/{groupId}"
tags: ["Queue User Group V4"]
---

# Update an existing user group

`PATCH /v4/queue-user-group/{groupId}`

## Request

- Base URL: `https://developer.meetergo.com` (the document declares no server; this is the origin it was published from)
- URL: `https://developer.meetergo.com/v4/queue-user-group/{groupId}`
- Auth: one of:
  - API key in header `x-meetergo-api-user-id`
  - HTTP bearer
  - HTTP bearer

## Path parameters

- `groupId` string, required

## Request body

- UpdateUserGroupDto
  - `name` string: Name of the user group
  - `capacity` number: Group capacity (minimum 1)
  - `userId` string: User to assign or deassign from group. Deprecated: send the full `userIds` set instead, so the result does not depend on how current your copy of the member list is.
  - `userIds` string[]: Full desired set of group member IDs. Replaces the membership in one transaction.
  - `mainGroupHostId` string, nullable: Main host user ID for the group (can be null to remove)

## Response `200`

User group updated successfully

- QueueUserGroupResponseDto
  - `id` string, required
  - `name` string, required
  - `capacity` number, required
  - `users` UserBasicDto[], required
    - `id` string, required
    - `givenName` string, required
    - `familyName` string, required
    - `picture` string
    - `slug` string, required
    - `userType` string, required
  - `userIds` string[], required
  - `queueId` string, required
  - `mainGroupHost` UserBasicDto
    - `id` string, required
    - `givenName` string, required
    - `familyName` string, required
    - `picture` string
    - `slug` string, required
    - `userType` string, required
  - `mainGroupHostId` string, nullable
  - `createdAt` string, required
  - `updatedAt` string, required
  - `deletedAt` string, nullable

## Other responses

- `400`: The request did not validate. `message` lists the constraints that failed.
- `401`: Missing, malformed, or expired credentials.
- `403`: Authenticated, but not allowed: the plan does not include this feature, or the token is scoped away from it.
- `404`: No such resource in your account. Resources belonging to another account are reported the same way.
- `429`: Rate limited. Back off and retry.

---

[API](https://skmtc.dev/meetergo/apis/meetergo-platform-api.md) · [All operations](https://skmtc.dev/meetergo/apis/meetergo-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/meetergo/apis/meetergo-platform-api/revisions/b5d66cd8be67?raw)