---
title: "Update a package group"
method: PUT
path: "/api/v1/package_groups/{id}"
tags: ["Packages & Services"]
---

# Update a package group

`PUT /api/v1/package_groups/{id}`

## Request

- Base URL: `https://api.checkcherry.com`
- URL: `https://api.checkcherry.com/api/v1/package_groups/{id}`
- Auth: none declared. Required headers: `Api-Key`

Updates an existing package group with the provided fields. Only fields included in the request body are modified — omitted fields remain unchanged.

Use this to rename a package group, toggle its booking-page visibility, or change how its packages are sorted and priced. To move a package group to a different service, manage it from the Package Manager in the app.

**Required permission:** `offerings_write`

## Path parameters

- `id` integer, required

## Headers

- `Api-Key` string, required

## Request body

- object
  - `name` string: The name of the package group
  - `sub_header` string: Short sub-heading shown under the package-group name on booking pages (max 100 characters)
  - `show_on_booking_page` boolean: Whether this package group is shown on public booking pages
  - `show_title_on_booking_page` boolean: Whether to show the package-group title on the booking page
  - `package_sort_preference` 'name' | 'price' | 'manual': How packages within this group are ordered
  - `pricing_mode` 'show' | 'delay': Whether pricing is shown or delayed during booking

## Response `200`

package group updated

---

[API](https://skmtc.dev/checkcherry/apis/check-cherry-business-api.md) · [All operations](https://skmtc.dev/checkcherry/apis/check-cherry-business-api/llms.txt) · [OpenAPI document](https://skmtc.dev/checkcherry/apis/check-cherry-business-api/revisions/84a9aabdf519?raw)