---
title: "Items Edit"
method: POST
path: "/catalogs/items/edit"
tags: ["Catalogs"]
---

# Items Edit

`POST /catalogs/items/edit`

Adds, updates or removes catalog items by ID.

## Headers

- `X-Batch-Project` string, required

## Request body

- object
  - `name` string, required — Name of the catalog.
  - `items` object[], required — List of catalog items to add or remove.
    - `id` string, required — Unique identifier of the catalog item.
    - `action` 'add' | 'remove', required — Action to perform on the catalog item.
    - `attributes` Attributes — A map of attribute keys to values. Key rules: - `url(...)` → value must be a valid URL - `date(...)` → value must be RFC 3339 or Unix timestamp - `^[a-z0-9_]+$` → regular attribute names

## Response `202`

If the POST to the API endpoint is successful you will receive an HTTP 202 confirmation and an indexing token. <br/>Once you get your indexing token, you can use it to check the indexing state with the view action.

- object
  - `indexing_token` string

## Other responses

- `401` — The Rest API Key is not valid for this project
- `429` — Too Many Requests
- `500` — Unexpected error
- `503` — Batch's services are under maintenance. Please try again later

---

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