---
title: "Delete deployment group"
method: DELETE
path: "/v1/default/deployment-groups/{group-id}"
tags: ["deployment-groups-api"]
---

# Delete deployment group

`DELETE /v1/default/deployment-groups/{group-id}`

## Request

- Base URL: `https://api.bymason.com`
- URL: `https://api.bymason.com/v1/default/deployment-groups/{group-id}`
- Auth: API key in header `Authorization`

Deletes a deployment group. This operation is not allowed when there
are any devices in the group. The group named `unassigned` is a special 
group that can not be deleted.

## Path parameters

- `group-id` string, uuid, required

## Response `200`

Delete group success

- DeploymentGroupDeleted
  - `id` string, uuid: id of the deleted deployment group

## Other responses

- `400`: Bad request
- `404`: The resource requested does not exist
- `500`: Internal server error

---

[API](https://skmtc.dev/bymason/apis/mason-platform-apis-docs.md) - [All operations](https://skmtc.dev/bymason/apis/mason-platform-apis-docs/llms.txt) - [OpenAPI document](https://skmtc.dev/bymason/apis/mason-platform-apis-docs/revisions/365b123b04d4?raw)