---
title: "Delete a group"
description: "Deletes a group on Mindtickle by group ID."
contentType: "api-reference"
url: "https://developer.mindtickle.com/docs/users-and-groups/groups/delete-a-group/"
---

## Prerequisites

1. [Authentication and setup](/docs/getting-started/authentication-and-setup/): A valid access token.
2. [Create a group](/docs/users-and-groups/groups/create-a-group/): The group must exist.

## Endpoint

```http
DELETE /services/data/v2.0/mtobjects/Group/GROUP_ID
```

Base URL: the standard REST host for your region. See [Base URLs](/docs/getting-started/authentication-and-setup/#base-urls).

Headers: `Authorization: Bearer ACCESS_TOKEN`.

## Path parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `GROUP_ID` | string | Required | Mindtickle ID of the group. |

## Request

This endpoint has no request body.

## Response

| Field | Type | Description |
| --- | --- | --- |
| `requestId` | string or null | Request identifier. The response examples return `null`. |
| `responseCode` | integer | Special response codes from the server. |
| `responseType` | string | Type of response from the server. |
| `taskCompleted` | boolean | Completion flag for this request. This endpoint returns its result directly. |
| `deleted` | boolean | Flag for the group deletion task. `true` means the group is successfully deleted from Mindtickle. |

### Response example

```json
{
  "requestId": null,
  "responseCode": 0,
  "responseType": "DELETED_RESPONSE",
  "taskCompleted": true,
  "deleted": true
}
```

## Related

- [Search groups](/docs/users-and-groups/groups/search-groups/): Find the group ID this endpoint needs.
- [Remove users from a group](/docs/users-and-groups/users/remove-users-from-a-group/): Remove users from the group instead of deleting it.