---
title: "DELETE /user-hierarchy-groups/{InstanceId}/{HierarchyGroupId}"
method: DELETE
path: "/user-hierarchy-groups/{InstanceId}/{HierarchyGroupId}"
---

# DELETE /user-hierarchy-groups/{InstanceId}/{HierarchyGroupId}

`DELETE /user-hierarchy-groups/{InstanceId}/{HierarchyGroupId}`

Deletes an existing user hierarchy group. It must not be associated with any agents or have any active child groups.

## Path parameters

- `HierarchyGroupId` string, required
- `InstanceId` string, required

## Response `200`

Success

## Other responses

- `480` — InvalidRequestException
- `481` — InvalidParameterException
- `482` — ResourceNotFoundException
- `483` — ResourceInUseException
- `484` — ThrottlingException
- `485` — InternalServiceException

---

[API](https://skmtc.net/aws/apis/connect.md) · [All operations](https://skmtc.net/aws/apis/connect/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/connect/versions/fbcf0a4faed2/schema)