---
title: "Delete a group"
method: DELETE
path: "/authorization/groups/{groupId}"
tags: ["Authorization"]
---

# Delete a group

`DELETE /authorization/groups/{groupId}`

## Request

- Base URL: `https://example.itential.io`
- URL: `https://example.itential.io/authorization/groups/{groupId}`
- Auth: none declared

Deletes a group.

## Path parameters

- `groupId` string, required: String representation of a MongoDB ObjectId

## Response `200`

Result of group deletion process

- AuthorizationDeleteGroupResponse200
  - `status` 'OK' | 'Created': The status of the API request.
  - `message` string: Message containing either confirmation of the operation or the reason for the failure of the operation.

## Other responses

- `500`: Error response from API

---

[API](https://skmtc.dev/itential/apis/itential-2.md) - [All operations](https://skmtc.dev/itential/apis/itential-2/llms.txt) - [OpenAPI document](https://skmtc.dev/itential/apis/itential-2/revisions/2095cc90e583?raw)