---
title: "Create or update item groups (Deprecated)"
method: PATCH
path: "/v1/item_groups"
tags: ["Item groups"]
deprecated: true
---

# Create or update item groups (Deprecated)

`PATCH /v1/item_groups`

> **Deprecated.**

**🔐 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)`.

Update item groups. If the item groups already exist, they will be updated. If not, they will be created.

## Query parameters

- `key` string, required — The key of the index to use.
- `section` string — The section of the index to use. Defaults to `Products`.
- `c` string — The ID of the client and version that the request is coming from, such as `cio-js-2.90`.

## Request body

- ItemGroupListPatchRequestBody
  - `item_groups` V1ItemGroup[], required
    - `data` object — Object containing additional data, that should be attached to this item group. The maximum size of data object is limited to 5kb. The average size of data objects for all ingested item groups should not exceed 1kb.
    - `id` string, required — ID of the item group.
    - `name` string, required — Item group display name.
    - `children` object[] — A list of item groups categorized under the current item group.

## Response `200`

OK

- ItemGroupListPatchResponse
  - `item_groups` ItemGroupCountModel, required
    - `processed` integer, required — Number of item groups processed.
    - `inserted` integer, required — Number of item groups inserted.
    - `updated` integer, required — Number of item groups updated.
    - `deleted` integer, required — Number of item groups deleted.

## Other responses

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

---

[API](https://skmtc.dev/constructor/apis/autocomplete.md) · [All operations](https://skmtc.dev/constructor/apis/autocomplete/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/constructor/autocomplete/revisions/2d33330633b6/schema)