---
title: "Delete item groups"
method: DELETE
path: "/v2/item_groups"
tags: ["Item groups"]
---

# Delete item groups

`DELETE /v2/item_groups`

## Request

- Base URL: `https://ac.cnstrc.com`
- URL: `https://ac.cnstrc.com/v2/item_groups`
- Auth: one of:
  - HTTP basic
  - HTTP bearer

**🔐 This endpoint requires [HTTP authentication](https://docs.constructor.com/reference/main-authentication) (either [Basic](https://docs.constructor.com/reference/main-authentication#basic-authentication) or [Bearer](https://docs.constructor.com/reference/main-authentication#bearer-authentication)).**
For authenticating with Bearer token, required scopes are: `catalog(w)`.

Delete item groups. Returns an identifier for a background [task](/reference/v1-tasks-retrieve-task).

## Query parameters

- `key` string, required: The key of the index to use.
- `c` string: The ID of the client and version that the request is coming from, such as `cio-js-2.90`.
- `force` boolean: A flag to process the catalog even if it will invalidate a large part of existing data. Defaults to `False`.
- `notification_email` string[]: The email address(es) to send a notification to if the task fails. Multiple addresses may be specified for multiple recipients.

## Request body

- ItemGroupsListDeleteRequestBody
  - `item_groups` ItemGroupBase[], required: Array of item group IDs you want to delete.
    - `id` string, required: ID of the item group.

## Response `200`

OK

- ItemGroupsListDeleteResponse
  - `task_id` integer, required
  - `task_status_path` string, required

## Other responses

- `400`: Validation Error
- `401`: Credentials are not passed or action is forbidden.
- `403`: The supplied token does not have the required permissions.
- `409`: Conflict
- `429`: Rate limit breached

---

[API](https://skmtc.dev/constructor/apis/catalog-management.md) - [All operations](https://skmtc.dev/constructor/apis/catalog-management/llms.txt) - [OpenAPI document](https://skmtc.dev/constructor/apis/catalog-management/revisions/3a9833796fc6?raw)