{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Create a catalog item bulk update job to update a batch of catalog items.\n\nAccepts up to 100 catalog items per request. The maximum allowed payload size is 5MB. The maximum number of jobs in progress at one time is 500.<br><br>*Rate limits*:<br>Burst: `75/s`<br>Steady: `750/m`\n\n**Scopes:**\n`catalogs:write`\n\n[OpenAPI Spec](https://raw.githubusercontent.com/klaviyo/openapi/main/openapi/stable/apis/bulk_update_catalog_items.json)","properties":{"query":{"type":"object","properties":{"fields[catalog-item-bulk-update-job]":{"type":"array","items":{"type":"string","enum":["completed_at","completed_count","created_at","errors","expires_at","failed_count","id","status","total_count"]},"description":"For more information please visit https://developers.klaviyo.com/en/v2026-10-15/reference/api-overview#sparse-fieldsets"}},"required":[],"additionalProperties":false},"headers":{"type":"object","properties":{"revision":{"type":"string","default":"2026-10-15","enum":["2026-10-15"],"description":"API endpoint revision (format: YYYY-MM-DD[.suffix])"}},"required":["revision"],"additionalProperties":false},"body":{"$ref":"#/definitions/CatalogItemUpdateJobCreateQuery"}},"required":["headers","body"],"additionalProperties":false,"definitions":{"CatalogItemUpdateJobCreateQuery":{"type":"object","properties":{"data":{"$ref":"#/definitions/CatalogItemUpdateJobCreateQueryResourceObject"}},"required":["data"]},"CatalogItemUpdateJobCreateQueryResourceObject":{"type":"object","properties":{"type":{"$ref":"#/definitions/CatalogItemBulkUpdateJobEnum"},"attributes":{"type":"object","properties":{"items":{"description":"Array of catalog items to update.","type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/definitions/CatalogItemUpdateQueryResourceObject"}}},"required":["data"]}},"required":["items"]}},"required":["type","attributes"]},"CatalogItemBulkUpdateJobEnum":{"type":"string","enum":["catalog-item-bulk-update-job"]},"CatalogItemUpdateQueryResourceObject":{"type":"object","properties":{"type":{"$ref":"#/definitions/CatalogItemEnum"},"id":{"description":"The catalog item ID is a compound ID (string), with format: `{integration}:::{catalog}:::{external_id}`. Currently, the only supported integration type is `$custom`, and the only supported catalog is `$default`.","type":"string","examples":["$custom:::$default:::SAMPLE-DATA-ITEM-1"]},"attributes":{"type":"object","properties":{"title":{"description":"The title of the catalog item.","type":["string","null"],"examples":["Ocean Blue Shirt (Sample)"]},"price":{"description":"This field can be used to set the price on the catalog item, which is what gets displayed for the item when included in emails. For most price-update use cases, you will also want to update the `price` on any child variants, using the [Update Catalog Variant Endpoint](https://developers.klaviyo.com/en/reference/update_catalog_variant).","type":["number","null"],"examples":[42]},"description":{"description":"A description of the catalog item.","type":["string","null"],"examples":["A description of the catalog item."]},"url":{"description":"URL pointing to the location of the catalog item on your website.","type":["string","null"],"examples":["https://via.placeholder.com/150"]},"image_full_url":{"description":"URL pointing to the location of a full image of the catalog item.","type":["string","null"],"examples":["https://via.placeholder.com/300"]},"image_thumbnail_url":{"description":"URL pointing to the location of an image thumbnail of the catalog item","type":["string","null"],"examples":["https://via.placeholder.com/150"]},"images":{"description":"List of URLs pointing to the locations of images of the catalog item.","type":["array","null"],"items":{"type":"string"},"examples":[["https://via.placeholder.com/150"]]},"custom_metadata":{"description":"Flat JSON blob to provide custom metadata about the catalog item. May not exceed 100kb.","type":["object","null"],"examples":[{"Top Pick":true}]},"published":{"description":"Boolean value indicating whether the catalog item is published.","type":["boolean","null"],"examples":[true]}}},"relationships":{"type":"object","properties":{"categories":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["type","id"],"properties":{"type":{"$ref":"#/definitions/CatalogCategoryEnum"},"id":{"description":"A list of catalog category IDs representing the categories the item is in","type":"string","examples":["$custom:::$default:::SAMPLE-DATA-CATEGORY-APPAREL"]}}}}}}}}},"required":["type","id","attributes"]},"CatalogItemEnum":{"type":"string","enum":["catalog-item"]},"CatalogCategoryEnum":{"type":"string","enum":["catalog-category"]}}},"name":"Bulk Update Catalog Items","id":"klaviyo.bulk_update_catalog_items","example":{"headers":{"revision":"2026-10-15"},"body":{"data":{"type":"catalog-item-bulk-update-job","attributes":{"items":{"data":[]}}}}},"maxRequests":1,"summary":false}}