---
title: "Add or update meta-data for a field group"
method: PUT
path: "/channels/{channel_id}/fieldgroups/{fieldgroup_name}"
tags: ["Channel Operations"]
---

# Add or update meta-data for a field group

`PUT /channels/{channel_id}/fieldgroups/{fieldgroup_name}`

## Request

- Base URL: `https://developers.bloomreach.io/delivery/site/v2/documents`
- URL: `https://developers.bloomreach.io/delivery/site/v2/documents/channels/{channel_id}/fieldgroups/{fieldgroup_name}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/bloomreach/apis/documents-delivery-api-2-0/docs/channels/:channel_id/fieldgroups/:fieldgroup_name/put.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `channel_id` string, required
- `fieldgroup_name` string, required

## Headers

- `X-Resource-Version` string

## Request body

- FieldGroup
  - `name` string: Field Group Name
  - `displayName` string: Field Group Display Name
  - `parameters` string[]: Field Group Parameters

## Response `200`

OK

- FieldGroup
  - `name` string: Field Group Name
  - `displayName` string: Field Group Display Name
  - `parameters` string[]: Field Group Parameters

## Other responses

- `201`: Created
- `403`: Forbidden

---

[API](https://skmtc.dev/bloomreach/apis/documents-delivery-api-2-0.md) - [All operations](https://skmtc.dev/bloomreach/apis/documents-delivery-api-2-0/llms.txt) - [OpenAPI document](https://skmtc.dev/bloomreach/apis/documents-delivery-api-2-0/revisions/87bfc06578c2?raw)
