---
title: "Update Group"
method: PUT
path: "/api/chunk_group"
tags: ["Chunk Group"]
---

# Update Group

`PUT /api/chunk_group`

Update a chunk_group. One of group_id or tracking_id must be provided. If you try to change the tracking_id to one that already exists, this operation will fail. Auth'ed user or api key must have an admin or owner role for the specified dataset's organization.

## Headers

- `TR-Dataset` string, uuid, required

## Request body

- UpdateChunkGroupReqPayload
  - `description` string, nullable — Description to assign to the chunk_group. Convenience field for you to avoid having to remember what the group is for. If not provided, the description will not be updated.
  - `group_id` string, uuid, nullable — Id of the chunk_group to update.
  - `metadata` unknown
  - `name` string, nullable — Name to assign to the chunk_group. Does not need to be unique. If not provided, the name will not be updated.
  - `tag_set` string[], nullable — Optional tags to assign to the chunk_group. This is a list of strings that can be used to categorize the chunks inside the chunk_group.
  - `tracking_id` string, nullable — Tracking Id of the chunk_group to update.
  - `update_chunks` boolean, nullable — Flag to update the chunks in the group. If true, each chunk in the group will be updated by appending the group's tags to the chunk's tags. Default is false.

## Response `204`

Confirmation that the chunkGroup was updated

## Other responses

- `400` — Service error relating to updating the chunkGroup

---

[API](https://skmtc.net/devflowinc/apis/trieve-api.md) · [All operations](https://skmtc.net/devflowinc/apis/trieve-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/devflowinc/trieve-api/versions/84583e7c9fc1/schema)
