---
title: "Rename a guest group"
method: PUT
path: "/v1/guests/groups/{groupId}/"
tags: ["Guests"]
---

# Rename a guest group

`PUT /v1/guests/groups/{groupId}/`

## Request

- Base URL: `https://api.educaplay.com`
- URL: `https://api.educaplay.com/v1/guests/groups/{groupId}/`
- Auth: HTTP bearer

## Path parameters

- `groupId` integer, required

## Response `200`

Group renamed.

- GuestGroup
  - `id` integer, required
  - `name` string, required
  - `count` integer: Number of guests tagged with this group. Only present when listing groups.

## Other responses

- `401`: Authentication is missing or the Bearer token is invalid.
- `404`: The group does not exist or is not yours.
- `429`: The request rate limit for the account has been exceeded. Limits depend on the subscription plan (Basic 120, Advanced 300, Academic 600 and Commercial 1200 requests per minute) and are measured over a fixed 60 second window. Wait the number of seconds given in the `Retry-After` header before retrying.

## Changes

- **2026-10-19** `e31d97013d0d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/educaplay/apis/educaplay-api/changes/v1/guests/groups/:groupId/put.md)

---

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