---
title: "Update Coverage Group"
method: PATCH
path: "/scheduling/coverage-groups/{group_id}"
tags: ["scheduling"]
---

# Update Coverage Group

`PATCH /scheduling/coverage-groups/{group_id}`

## Request

- Base URL: `https://api.verdun.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.verdun.ai/scheduling/coverage-groups/{group_id}`
- Auth: HTTP bearer

## Path parameters

- `group_id` string, required

## Request body

- UpdateCoverageGroupRequest
  - `name` string, nullable: New display name (omit to keep the current one).
  - `color` string, nullable: New display color (omit to keep the current one).

## Response `200`

Successful Response

- UpdateCoverageGroupResponse
  - `group` CoverageGroupModel, required
    - `id` string, uuid, required: The coverage group ID.
    - `name` string, required: Display name of the group.
    - `color` string, required: Display color used in schedule grids and chips.
    - `grants` CoverageGrantModel[], required: The parent/site grants that define the group's sites.
      - `id` string, uuid, required: The grant ID.
      - `parent_id` string, uuid, nullable: Parent granted wholesale - covers every current AND future site under it (null for site grants).
      - `site_id` string, uuid, nullable: Individually granted site (null for parent grants).
    - `site_count` integer, required: Distinct sites currently covered (parent grants expanded).
    - `members` CoverageGroupMemberModel[]: Operators who are standing members of this group. Their tenant scope includes this group's sites -- SCOPE ONLY, never a permission. Deleting a group with members is refused (409).
      - `id` string, uuid, required: The operator ID.
      - `first_name` string, required: Member's first name.
      - `last_name` string, required: Member's last name.
      - `role` 'owner' | 'operator' | 'site_manager' | 'read_only' | 'account_manager' | 'monitoring_manager' | 'location_manager' | 'support', required
    - `member_count` integer: How many operators are standing members of this group.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/verdun/apis/verdun-api.md) - [All operations](https://skmtc.dev/verdun/apis/verdun-api/llms.txt) - [OpenAPI document](https://skmtc.dev/verdun/apis/verdun-api/revisions/a19366be50a3?raw)