---
title: "Create or update a channel component group"
method: PUT
path: "/channels/{channel_id}/component_groups/{group_name}"
tags: ["Channel Component Operations"]
---

# Create or update a channel component group

`PUT /channels/{channel_id}/component_groups/{group_name}`

## Path parameters

- `channel_id` string, required
- `group_name` string, required

## Headers

- `X-Resource-Version` string

## Request body

- CatalogGroup
  - `name` string, required — identifying name of a catalog group for its channel; "base" is a reserved and predefined (system) group name
  - `hidden` boolean — indicator if this catalog group (and its resources, e.g. components) will be available in the ChannelManager UI
  - `system` boolean — indicator if this catalog group (and its resources, e.g. components) are protected; if true implies hidden is true

## Response `200`

OK

- CatalogGroup
  - `name` string, required — identifying name of a catalog group for its channel; "base" is a reserved and predefined (system) group name
  - `hidden` boolean — indicator if this catalog group (and its resources, e.g. components) will be available in the ChannelManager UI
  - `system` boolean — indicator if this catalog group (and its resources, e.g. components) are protected; if true implies hidden is true

## Other responses

- `201` — Created
- `403` — Forbidden

---

[API](https://skmtc.net/bloomreach/apis/documents-delivery-api-2-0.md) · [All operations](https://skmtc.net/bloomreach/apis/documents-delivery-api-2-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bloomreach/documents-delivery-api-2-0/revisions/87bfc06578c2/schema)