---
title: "Create or update rich item"
method: PUT
path: "/i/richItem/{businessId}/{sku}"
tags: ["Rich Item"]
---

# Create or update rich item

`PUT /i/richItem/{businessId}/{sku}`

## Request

- Base URL: `https://api.trial.lsk.lightspeed.app`
- URL: `https://api.trial.lsk.lightspeed.app/i/richItem/{businessId}/{sku}`
- Auth: OAuth 2
  - Authorization code: `https://auth.lsk-prod.app/realms/k-series/protocol/openid-connect/auth`
  - Token URL: `https://auth.lsk-prod.app/realms/k-series/protocol/openid-connect/token` scopes: `orders-api`

Creates a new rich item or updates an existing rich item. To update the sku, set the new sku in the request body. The picture cannot be set using this method (use PATCH method).

## Path parameters

- `businessId` integer, required: The unique identifier for the business.
- `sku` string, required: The SKU of the item.

## Request body

- object
  - `businessId` integer, required: The id of the business
  - `sku` string, required: A stock-keeping unit
  - `allergenCodes` string[]: List of allergen codes
  - `descriptions` TeckelRichItemDescriptionDto[]: List of localized descriptions
    - `localeCode` string, required: The language code (ISO 639) of the description.
    - `description` string: The item description in the language of the locale.
    - `displayName` string: The display name of the item in the language of the locale.

## Response `200`

Updated

- object
  - `businessId` integer: The unique identifier for the business.
  - `sku` string: The SKU of the item.
  - `descriptions` TeckelRichItemDescriptionDto[]: List of localized descriptions
    - `localeCode` string, required: The language code (ISO 639) of the description.
    - `description` string: The item description in the language of the locale.
    - `displayName` string: The display name of the item in the language of the locale.
  - `allergenCodes` string[]: List of allergen codes.
  - `creationDate` string, date-time: The creation date of the item.
  - `lastUpdateDate` string, date-time: The last update date of the item.
  - `pictureUrl` string: The URL of the picture.
  - `previewPictureUrl` string: The URL of the preview picture.
  - `rawPictureUrl` string: The URL of the raw picture.

## Changes

> 31 revisions in range; 1 not diffed.

- **2026-02-12** `33472358c1ed`: 1 info
  - added the optional property `allOf[#/components/schemas/teckelRichItemDtoPictures]/previewPictureUrl` to the response with the `200` status

[Operation history](https://skmtc.dev/lightspeed/apis/lightspeed-restaurant-k-series-api/changes/i/richItem/:businessId/:sku/put.md)

---

[API](https://skmtc.dev/lightspeed/apis/lightspeed-restaurant-k-series-api.md) - [All operations](https://skmtc.dev/lightspeed/apis/lightspeed-restaurant-k-series-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lightspeed/apis/lightspeed-restaurant-k-series-api/revisions/af001485cf2b?raw)