---
title: "Update Group and set businesses"
method: POST
path: "/sections/{section_id}/groups/{group_id}"
tags: ["Groups and Sections"]
---

# Update Group and set businesses

`POST /sections/{section_id}/groups/{group_id}`

Update a group.
This endpoint allows you to modify the details of an existing group within the system.   Only `Group Managers` and higher roles can use this endpoint. `Business Managers` are restricted from accessing it.   For more information about the group system, see [the Groups and Sections description](/guides/api/resources/organizations/groups).
⚠️ You must specify which businesses are part of the group using the `business__in` parameter.
- If you don't specify any businesses, the group will be updated to include **all** businesses. - To update a group to be empty, provide an empty array in the `business__in` parameter.

## Path parameters

- `section_id` integer, required
- `group_id` integer, required

## Request body

- object — Request body to update a group
  - `name` string, required — Name of the group. Cannot include any of the following characters: `,;/`
  - `business__in` BusinessId[], required — List of business ids

## Response `200`

OK

- GroupCreateSuccessResponse
  - `status` 'success' — Request status
  - `id` integer — ID of the created group

## Other responses

- `400` — Group name already exists
- `401` — You are not authenticated
- `403` — You are not allowed to perform this action

---

[API](https://skmtc.net/partoo/apis/partoo-rest-api.md) · [All operations](https://skmtc.net/partoo/apis/partoo-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/partoo/partoo-rest-api/revisions/3652d8b1a8b3/schema)