---
title: "Create or update a catalog item"
method: PATCH
path: "/api/catalogs/{catalogName}/items/{itemId}"
tags: ["catalogs"]
---

# Create or update a catalog item

`PATCH /api/catalogs/{catalogName}/items/{itemId}`

Asynchronous. Create or update the specified catalog item in the given catalog. A catalog item's ID must be unique, contain only alphanumeric characters and dashes, and have a maximum length of 255 characters. If the catalog item already exists, its fields will be updated with the values provided in the request body. Previously existing fields not included in the request body will remain as is. Do not use periods in field names.

## Path parameters

- `catalogName` string, required
- `itemId` string, required

## Request body

- CatalogUpdateItemRequest
  - `update` object, required — JSON representation of the catalog item fields to update. Max size is is 30kb.

## Response `200`

successful operation

## Other responses

- `202` — Catalog item update request received. Use GET /api/catalogs/{catalogName}/items/{itemId} to verify completion.
- `400` — Invalid parameters
- `401` — Invalid API key

---

[API](https://skmtc.net/iterable/apis/iterable-api.md) · [All operations](https://skmtc.net/iterable/apis/iterable-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/iterable/iterable-api/revisions/afaab604b58c/schema)