---
name: catalog-routes
description: Handle 14 OpenAPI operation(s) under /v2/catalog for the catalog route group.
---

# catalog API Routes

Handle 14 OpenAPI operation(s) under /v2/catalog for the catalog route group.

Use the generated operation tools to make real API calls. Do not invent API responses.
If a tool reports missing setup, return the exact setup field name to the caller.
For write, update, or delete operations, state the intended action before calling the tool.

## Operations

### batch_delete_catalog_objects

- Operation ID: `batch_delete_catalog_objects`
- Route: `POST /v2/catalog/batch-delete`
- Mode: WRITE
- Summary: BatchDeleteCatalogObjects
- Body: JSON request body accepted.

### batch_retrieve_catalog_objects

- Operation ID: `batch_retrieve_catalog_objects`
- Route: `POST /v2/catalog/batch-retrieve`
- Mode: WRITE
- Summary: BatchRetrieveCatalogObjects
- Body: JSON request body accepted.

### batch_upsert_catalog_objects

- Operation ID: `batch_upsert_catalog_objects`
- Route: `POST /v2/catalog/batch-upsert`
- Mode: WRITE
- Summary: BatchUpsertCatalogObjects
- Body: JSON request body accepted.

### create_catalog_image

- Operation ID: `create_catalog_image`
- Route: `POST /v2/catalog/images`
- Mode: WRITE
- Summary: CreateCatalogImage
- Body: JSON request body accepted.

### update_catalog_image

- Operation ID: `update_catalog_image`
- Route: `PUT /v2/catalog/images/{image_id}`
- Mode: WRITE
- Summary: UpdateCatalogImage
- Parameters:
  - `image_id` in `path` required
- Body: JSON request body accepted.

### catalog_info

- Operation ID: `catalog_info`
- Route: `GET /v2/catalog/info`
- Mode: READ
- Summary: CatalogInfo

### list_catalog

- Operation ID: `list_catalog`
- Route: `GET /v2/catalog/list`
- Mode: READ
- Summary: ListCatalog
- Parameters:
  - `cursor` in `query`
  - `types` in `query`
  - `catalog_version` in `query`

### upsert_catalog_object

- Operation ID: `upsert_catalog_object`
- Route: `POST /v2/catalog/object`
- Mode: WRITE
- Summary: UpsertCatalogObject
- Body: JSON request body accepted.

### delete_catalog_object

- Operation ID: `delete_catalog_object`
- Route: `DELETE /v2/catalog/object/{object_id}`
- Mode: WRITE
- Summary: DeleteCatalogObject
- Parameters:
  - `object_id` in `path` required

### retrieve_catalog_object

- Operation ID: `retrieve_catalog_object`
- Route: `GET /v2/catalog/object/{object_id}`
- Mode: READ
- Summary: RetrieveCatalogObject
- Parameters:
  - `object_id` in `path` required
  - `include_related_objects` in `query`
  - `catalog_version` in `query`
  - `include_category_path_to_root` in `query`

### search_catalog_objects

- Operation ID: `search_catalog_objects`
- Route: `POST /v2/catalog/search`
- Mode: WRITE
- Summary: SearchCatalogObjects
- Body: JSON request body accepted.

### search_catalog_items

- Operation ID: `search_catalog_items`
- Route: `POST /v2/catalog/search-catalog-items`
- Mode: WRITE
- Summary: SearchCatalogItems
- Body: JSON request body accepted.

### update_item_modifier_lists

- Operation ID: `update_item_modifier_lists`
- Route: `POST /v2/catalog/update-item-modifier-lists`
- Mode: WRITE
- Summary: UpdateItemModifierLists
- Body: JSON request body accepted.

### update_item_taxes

- Operation ID: `update_item_taxes`
- Route: `POST /v2/catalog/update-item-taxes`
- Mode: WRITE
- Summary: UpdateItemTaxes
- Body: JSON request body accepted.