---
title: "Update collector group."
method: PUT
path: "/collectorGroups/{key}"
tags: ["collectorGroups"]
---

# Update collector group.

`PUT /collectorGroups/{key}`

Update all fields, replacing any existing values, and if a field is not provided, it resets to default (e.g. empty array of collectors, empty description).

## Path parameters

- `key` string, required

## Request body

- object — A collector group.
  - `description` string — A description of the collector group.
  - `name` string, required — A unique and descriptive name for the collector group.
  - `collectors` string[] — List of collectors for the group.
  - `generators` string[] — List of generators assigned to this group.
  - `owner` string — The name of the user to assign as the owner. Defaults to the user that created it

## Response `200`

Success, returns the updated collector group.

- CollectorGroupsResponse — The group of collectors
  - `description` string — A description of the collector group.
  - `createdBy` string — Id of the user who created the collector group.
  - `id` string — The collector group id.
  - `name` string — The collector group name.
  - `collectors` object[] — List of collectors for the group.

## Other responses

- `400` — Bad Request
- `401` — Authentication Error
- `403` — Resource Not Found
- `404` — Resource Not Found
- `default` — Error

---

[API](https://skmtc.dev/salesforce/apis/refocus-api.md) · [All operations](https://skmtc.dev/salesforce/apis/refocus-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/salesforce/refocus-api/revisions/42c2153b047e/schema)