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

# Create or replace a catalog item

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

Asynchronous. Create or replace 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, it will be replaced by the value provided in the request body. Do not use periods in field names.<br/><br/><b>Rate limit</b>: 1000 requests/second, per API key.

## Path parameters

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

## Request body

- CatalogIndexItemRequest
  - `value` object, required — JSON representation of the catalog item. 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
- `500` — Internal server error

---

[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)