---
title: "Bulk Update Item Categories"
method: PATCH
path: "/v1/item_categories"
tags: ["Item Categories"]
---

# Bulk Update Item Categories

`PATCH /v1/item_categories`

Updates multiple categories.

## Request body

- ItemCategoryBulkUpdate[]
  - `name` string
  - `description` string
  - `position` integer
  - `parent_id` string
  - `item_template_id` string
  - `pinned_expression` ExpressionV2
    - `tokens` TokenV2[]
      - `type` 'attribute' | 'custom_attribute' | 'event_attribute' | 'custom_event_attribute' | 'operator' | 'number' | 'date' | 'string' | 'boolean' | 'list' | 'variable' | 'virtual_currency', required
      - `value` unknown
    - `variables` MathExpressionV2[]
      - `tokens` TokenV2[]
        - `type` 'attribute' | 'custom_attribute' | 'event_attribute' | 'custom_event_attribute' | 'operator' | 'number' | 'date' | 'string' | 'boolean' | 'list' | 'variable' | 'virtual_currency', required
        - `value` unknown
      - `name` string, required
  - `slug` string
  - `icon` string
  - `image_url` string, uri
  - `divider_image_url` string, uri
  - `divider_position` 'top' | 'bottom'
  - `divider_type` 'image' | 'mask'
  - `background_color` string
  - `background_image_url` string, uri
  - `background_size` 'contain' | 'repeat' | 'cover'
  - `render_type` 'default' | 'carousel'
  - `render_options` StoreCategoryRenderOptions
    - `delay` integer
    - `loop` boolean
    - `autoplay` boolean
    - `show_dots` boolean
    - `display_type` 'default' | 'compact' | 'alone'
  - `child_sort_attribute_name` string
  - `id` string, required

## Response `200`

Successful Response

- ItemCategoryRead[]
  - `name` string, required
  - `description` string
  - `position` integer, required
  - `parent_id` string
  - `item_template_id` string
  - `pinned_expression` ExpressionV2
    - `tokens` TokenV2[]
      - `type` 'attribute' | 'custom_attribute' | 'event_attribute' | 'custom_event_attribute' | 'operator' | 'number' | 'date' | 'string' | 'boolean' | 'list' | 'variable' | 'virtual_currency', required
      - `value` unknown
    - `variables` MathExpressionV2[]
      - `tokens` TokenV2[]
        - `type` 'attribute' | 'custom_attribute' | 'event_attribute' | 'custom_event_attribute' | 'operator' | 'number' | 'date' | 'string' | 'boolean' | 'list' | 'variable' | 'virtual_currency', required
        - `value` unknown
      - `name` string, required
  - `slug` string
  - `icon` string
  - `image_url` string
  - `divider_image_url` string
  - `divider_position` 'top' | 'bottom'
  - `divider_type` 'image' | 'mask'
  - `background_color` string
  - `background_image_url` string
  - `background_size` 'contain' | 'repeat' | 'cover'
  - `render_type` 'default' | 'carousel'
  - `render_options` StoreCategoryRenderOptions
    - `delay` integer
    - `loop` boolean
    - `autoplay` boolean
    - `show_dots` boolean
    - `display_type` 'default' | 'compact' | 'alone'
  - `child_sort_attribute_name` string — Name of a player list attribute holding child category slugs in the order they must be shown.
  - `id` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/aghanim/apis/aghanim-server-to-server-api.md) · [All operations](https://skmtc.net/aghanim/apis/aghanim-server-to-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aghanim/aghanim-server-to-server-api/versions/f8569ba0d776/schema)