---
title: "Create Coverage Group"
method: POST
path: "/scheduling/coverage-groups"
tags: ["scheduling"]
---

# Create Coverage Group

`POST /scheduling/coverage-groups`

## 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`
- Auth: HTTP bearer

## Request body

- CreateCoverageGroupRequest
  - `name` string, required: Display name of the coverage group.
  - `color` string, nullable: Display color (hex). Server assigns one when omitted.

## Response `200`

Successful Response

- CreateCoverageGroupResponse
  - `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/00252d8227c1?raw)