---
title: "Delete groups"
method: DELETE
path: "/api/v2/bulk/groups"
tags: ["Groups"]
---

# Delete groups

`DELETE /api/v2/bulk/groups`

> 🔑
>
> Required OAuth scope: `groups:bulk`.

> 🚜
>
> This endpoint processes up to 2,000 objects asynchronously. For more information, see the [Bulk operations guide](https://360learning.readme.io/docs/bulk-operations-1).

Deletes multiple groups. It also deletes descendant groups and their contents. Upon submission, the request is queued. Use the provided URL in the response header to check the status of the bulk operation.

## Headers

- `360-api-version` 'v2.0', required

## Request body

- DeleteGroupsBody
  - `input` DeleteGroupDTO[], required — An array of objects, each specifying details for the group to be deleted.
    - `groupId` string, ObjectId, required — The unique ID of the group to delete.

## Response `202`

The operation is successfully created.

## Other responses

- `400` — The server cannot or will not process the request due to something that is perceived to be a client error.
- `401` — The given access token is either missing, invalid, has expired, or has been revoked.
- `403` — The given access token does not have the required OAuth scope to execute the request.
- `429` — The maximum number of concurrent operations has been reached.
- `503` — The bulk API is temporarily disabled.

---

[API](https://skmtc.net/360learning/apis/core-api.md) · [All operations](https://skmtc.net/360learning/apis/core-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/360learning/core-api/revisions/94b691b0b72c/schema)