---
title: "Delete a group"
method: POST
path: "/delete-group"
---

# Delete a group

`POST /delete-group`

Allows you to delete a group permanently from the system.

**Parameters:**

-   `companyKey` _(string, required)_ - The company's secret key.
-   `groupId` _(string, required)_ – The unique identifier of the group.

## Request body

- DeleteGroup
  - `companyKey` string
  - `groupId` string

## Response `200`

Success

- DeleteGroupResponse
  - `result` object

## Other responses

- `400` — ArgumntError

---

[API](https://skmtc.net/identomat/apis/generated-api.md) · [All operations](https://skmtc.net/identomat/apis/generated-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/identomat/generated-api/revisions/cda4b2b11372/schema)