---
title: "Patches items in batch"
method: PATCH
path: "/item"
tags: ["Item"]
---

# Patches items in batch

`PATCH /item`

## Request

- The document declares no server URL.
- Auth: API key in header `TWN-InstanceKey` and API key in header `TWN-Authentication`

Updates specified fields for up to 100 items and returns per-item results. Duplicate article numbers are applied in order; the last one wins.

## Request body

- ApiItemPatchBatchRequest[], nullable
  - `ArticleNumber` string: The article number. Uniquely identifies an item
  - `Patch` ApiItemPatch
    - `Name` string, nullable: New item name
    - `Price` number, double, nullable: New item price
    - `Brand` string, nullable: New item brand
    - `Stock` integer, nullable: New item stock
    - `GroupCode` string, nullable: New item group code
    - `Image` string, nullable: New item image url
    - `Url` string, nullable: New item url
    - `Categories` integer[], nullable: New collection of item categories
    - `Attributes` ApiItemAttributeCreate[], nullable: New collection of item attributes
      - `Key` string: Attribute key
      - `Values` string[]: List of attribute values
      - `ValuesMultilingual` ApiItemAttributeValue[], nullable: List of multilingual attribute values
        - `Value` string: The attribute value
        - `LanguageId` integer, nullable: Identifier of the language this value belongs to (if multilingual)
    - `Status` 'Active' | 'Inactive'

## Response `200`

OK

- ApiBatchResult
  - `TotalCount` integer: Total number of items submitted in the batch
  - `SucceededCount` integer: Number of items processed successfully
  - `FailedCount` integer: Number of items that failed
  - `Results` ApiBatchItemResult[]: Per-item outcomes, in request order
    - `Index` integer: Zero-based position of the item in the request
    - `Key` string: The key that identifies the item
    - `Status` 'Succeeded' | 'NotFound' | 'ValidationFailed' | 'Failed'
    - `Errors` ValidationError[], nullable: Validation or processing errors for this item
      - `Code` string: A code for the error that, in contrast to the error message, will never change.
      - `Message` string: Explanation of why the (validation) error occurred.
      - `Field` string: To which field in the request the errors relate to. Not defined in case the errors do not relate to a single specific field.

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests

---

[API](https://skmtc.dev/tweakwise/apis/app-api.md) - [All operations](https://skmtc.dev/tweakwise/apis/app-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tweakwise/apis/app-api/revisions/dc936bf76941?raw)