# Product

Important

Listing, creating, updating, and deleting products is deprecated as of REST API 2024-04. For more information, refer to the guide to the new product model.

The Product resource lets you update and create products in a merchant's store. You can use product variants with the Product resource to create or update different versions of the same product. You can also add or update product images.

You can add products to collections with the CustomCollection resource and the SmartCollection resource.

## Resource Properties ### Product * body_html: A description of the product. Supports HTML formatting. * Type: string * Example: "It's the small iPod with a big idea: Video." * created_at: The date and time (ISO 8601 format) when the product was created. * Type: date * Example: "2012-02-15T15:12:21-05:00" * handle: A unique human-friendly string for the product. Automatically generated from the product's title. Used by the Liquid templating language to refer to objects. * Type: string * Example: "ipod-nano" * id: An unsigned 64-bit integer that's used as a unique identifier for the product. Each id is unique across the Shopify system. No two products will have the same id, even if they're from different shops. * Type: integer * Example: 632910392 * images: A list of product image objects, each one representing an image associated with the product. * Type: array * Example: [{"id"=>850703190, "product_id"=>632910392, "position"=>1, "created_at"=>"2018-01-08T12:34:47-05:00", "updated_at"=>"2018-01-08T12:34:47-05:00", "width"=>110, "height"=>140, "src"=>"http://example.com/burton.jpg", "variant_ids"=>[{}]}] * options: The custom product properties. For example, Size, Color, and Material. Each product can have up to 3 options and each option value can be up to 255 characters. Product variants are made of up combinations of option values. Options cannot be created without values. To create new options, a variant with an associated option value also needs to be created. * Type: array * Example: {"id"=>594680422, "product_id"=>632910392, "name"=>"Color", "position"=>1, "values"=>["Pink", "Red", "Green", "Black"]} * product_type: A categorization for the product used for filtering and searching products. * Type: string * Example: "Cult Products" * published_at: The date and time (ISO 8601 format) when the product was published. Can be set to null to unpublish the product from the Online Store channel. * Type: date * Example: "2007-12-31T19:00:00-05:00" * published_scope: Whether the product is published to the Point of Sale channel. Valid values: * Type: string * Example: "global" * status: The status of the product. Valid values: * Type: string * Example: "active" * tags: A string of comma-separated tags that are used for filtering and search. A product can have up to 250 tags. Each tag can have up to 255 characters. * Type: string * Example: "Emotive, Flash Memory, MP3, Music" * template_suffix: The suffix of the Liquid template used for the product page. If this property is specified, then the product page uses a template called "product.suffix.liquid", where "suffix" is the value of this property. If this property is "" or null, then the product page uses the default template "product.liquid". (default: null) * Type: string * Example: "special" * title: The name of the product. * Type: string * Example: "IPod Nano - 8GB" * updated_at: The date and time (ISO 8601 format) when the product was last modified. A product's updated_at value can change for different reasons. For example, if an order is placed for a product that has inventory tracking set up, then the inventory adjustment is counted as an update. * Type: date * Example: "2012-08-24T14:01:47-04:00" * variants:

An array of product variants, each representing a different version of the product.

The position property is read-only. The position of variants is indicated by the order in which they are listed.

* Type: array * Example: [{"barcode"=>"1234_pink", "compare_at_price"=>nil, "created_at"=>"2012-08-24T14:01:47-04:00", "fulfillment_service"=>"manual", "grams"=>567, "weight"=>0.2, "weight_unit"=>"kg", "id"=>808950810, "inventory_item_id"=>341629, "inventory_management"=>"shopify", "inventory_policy"=>"continue", "inventory_quantity"=>10, "option1"=>"Pink", "position"=>1, "price"=>199.99, "product_id"=>632910392, "requires_shipping"=>true, "sku"=>"IPOD2008PINK", "taxable"=>true, "title"=>"Pink", "updated_at"=>"2012-08-24T14:01:47-04:00"}] * vendor: The name of the product's vendor. * Type: string * Example: "Apple" ## Retrieve a list of products Retrieve a list of products. ### Endpoint /admin/api/#{api_version}/products.json?ids=632910392,921728736 (GET) ### Parameters * api_version (required): * collection_id: Return products by product collection ID. * created_at_max: Return products created before a specified date. (format: 2014-04-25T16:15:47-04:00) * created_at_min: Return products created after a specified date. (format: 2014-04-25T16:15:47-04:00) * fields: Return only certain fields specified by a comma-separated list of field names. * handle: Return only products specified by a comma-separated list of product handles. * ids: Return only products specified by a comma-separated list of product IDs. * limit: Return up to this many results per page. * presentment_currencies: Return presentment prices in only certain currencies, specified by a comma-separated list of ISO 4217 currency codes. * product_type: Return products by product type. * published_at_max: Return products published before a specified date. (format: 2014-04-25T16:15:47-04:00) * published_at_min: Return products published after a specified date. (format: 2014-04-25T16:15:47-04:00) * published_status: Return products by their published status. * since_id: Return only products after the specified ID. * status: Return only products specified by a comma-separated list of statuses. * title: Return products by product title. * updated_at_max: Return products last updated before a specified date. (format: 2014-04-25T16:15:47-04:00) * updated_at_min: Return products last updated after a specified date. (format: 2014-04-25T16:15:47-04:00) * vendor: Return products by product vendor. ### Responses #### 200 Retrieve a list of products Examples: ##### Retrieve a list of specific products Request: ``` GET /admin/api/unstable/products.json ``` Response: ``` HTTP/1.1 200 OK {"products":[{"id":632910392,"title":"IPod Nano - 8GB","body_html":"

It's the small iPod with one very big idea: Video. Now the world's most popular music player, available in 4GB and 8GB models, lets you enjoy TV shows, movies, video podcasts, and more. The larger, brighter display means amazing picture quality. In six eye-catching colors, iPod nano is stunning all around. And with models starting at just $149, little speaks volumes.

","vendor":"Apple","product_type":"Cult Products","created_at":"2024-09-25T14:24:08-04:00","handle":"ipod-nano","updated_at":"2024-09-25T14:24:08-04:00","published_at":"2007-12-31T19:00:00-05:00","template_suffix":null,"published_scope":"web","tags":"Emotive, Flash Memory, MP3, Music","status":"active","admin_graphql_api_id":"gid://shopify/Product/632910392","variants":[{"id":808950810,"product_id":632910392,"title":"Pink","price":"199.00","position":1,"inventory_policy":"continue","compare_at_price":null,"option1":"Pink","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_pink","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008PINK","weight":1.25,"weight_unit":"lb","inventory_item_id":808950810,"inventory_quantity":10,"old_inventory_quantity":10,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/808950810","image_id":562641783},{"id":49148385,"product_id":632910392,"title":"Red","price":"199.00","position":2,"inventory_policy":"continue","compare_at_price":null,"option1":"Red","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_red","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008RED","weight":1.25,"weight_unit":"lb","inventory_item_id":49148385,"inventory_quantity":20,"old_inventory_quantity":20,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/49148385","image_id":null},{"id":39072856,"product_id":632910392,"title":"Green","price":"199.00","position":3,"inventory_policy":"continue","compare_at_price":null,"option1":"Green","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_green","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008GREEN","weight":1.25,"weight_unit":"lb","inventory_item_id":39072856,"inventory_quantity":30,"old_inventory_quantity":30,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/39072856","image_id":null},{"id":457924702,"product_id":632910392,"title":"Black","price":"199.00","position":4,"inventory_policy":"continue","compare_at_price":null,"option1":"Black","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_black","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008BLACK","weight":1.25,"weight_unit":"lb","inventory_item_id":457924702,"inventory_quantity":40,"old_inventory_quantity":40,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/457924702","image_id":null}],"options":[{"id":594680422,"product_id":632910392,"name":"Color","position":1,"values":["Pink","Red","Green","Black"]}],"images":[{"id":850703190,"alt":null,"position":1,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/850703190","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]},{"id":562641783,"alt":null,"position":2,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/562641783","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano-2.png?v=1727288648","variant_ids":[808950810]},{"id":378407906,"alt":null,"position":3,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/378407906","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]}],"image":{"id":850703190,"alt":null,"position":1,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/850703190","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]}},{"id":921728736,"title":"IPod Touch 8GB","body_html":"

The iPod Touch has the iPhone's multi-touch interface, with a physical home button off the touch screen. The home screen has a list of buttons for the available applications.

","vendor":"Apple","product_type":"Cult Products","created_at":"2024-09-25T14:24:08-04:00","handle":"ipod-touch","updated_at":"2024-09-25T14:24:08-04:00","published_at":"2008-09-25T20:00:00-04:00","template_suffix":null,"published_scope":"web","tags":"","status":"active","admin_graphql_api_id":"gid://shopify/Product/921728736","variants":[{"id":447654529,"product_id":921728736,"title":"Black","price":"199.00","position":1,"inventory_policy":"continue","compare_at_price":null,"option1":"Black","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_black","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2009BLACK","weight":1.25,"weight_unit":"lb","inventory_item_id":447654529,"inventory_quantity":13,"old_inventory_quantity":13,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/447654529","image_id":null}],"options":[{"id":891236591,"product_id":921728736,"name":"Title","position":1,"values":["Black"]}],"images":[],"image":null}]} ``` ##### Retrieve all products Request: ``` GET /admin/api/unstable/products.json ``` Response: ``` HTTP/1.1 200 OK {"products":[{"id":632910392,"title":"IPod Nano - 8GB","body_html":"

It's the small iPod with one very big idea: Video. Now the world's most popular music player, available in 4GB and 8GB models, lets you enjoy TV shows, movies, video podcasts, and more. The larger, brighter display means amazing picture quality. In six eye-catching colors, iPod nano is stunning all around. And with models starting at just $149, little speaks volumes.

","vendor":"Apple","product_type":"Cult Products","created_at":"2024-09-25T14:24:08-04:00","handle":"ipod-nano","updated_at":"2024-09-25T14:24:08-04:00","published_at":"2007-12-31T19:00:00-05:00","template_suffix":null,"published_scope":"web","tags":"Emotive, Flash Memory, MP3, Music","status":"active","admin_graphql_api_id":"gid://shopify/Product/632910392","variants":[{"id":808950810,"product_id":632910392,"title":"Pink","price":"199.00","position":1,"inventory_policy":"continue","compare_at_price":null,"option1":"Pink","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_pink","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008PINK","weight":1.25,"weight_unit":"lb","inventory_item_id":808950810,"inventory_quantity":10,"old_inventory_quantity":10,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/808950810","image_id":562641783},{"id":49148385,"product_id":632910392,"title":"Red","price":"199.00","position":2,"inventory_policy":"continue","compare_at_price":null,"option1":"Red","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_red","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008RED","weight":1.25,"weight_unit":"lb","inventory_item_id":49148385,"inventory_quantity":20,"old_inventory_quantity":20,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/49148385","image_id":null},{"id":39072856,"product_id":632910392,"title":"Green","price":"199.00","position":3,"inventory_policy":"continue","compare_at_price":null,"option1":"Green","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_green","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008GREEN","weight":1.25,"weight_unit":"lb","inventory_item_id":39072856,"inventory_quantity":30,"old_inventory_quantity":30,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/39072856","image_id":null},{"id":457924702,"product_id":632910392,"title":"Black","price":"199.00","position":4,"inventory_policy":"continue","compare_at_price":null,"option1":"Black","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_black","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008BLACK","weight":1.25,"weight_unit":"lb","inventory_item_id":457924702,"inventory_quantity":40,"old_inventory_quantity":40,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/457924702","image_id":null}],"options":[{"id":594680422,"product_id":632910392,"name":"Color","position":1,"values":["Pink","Red","Green","Black"]}],"images":[{"id":850703190,"alt":null,"position":1,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/850703190","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]},{"id":562641783,"alt":null,"position":2,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/562641783","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano-2.png?v=1727288648","variant_ids":[808950810]},{"id":378407906,"alt":null,"position":3,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/378407906","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]}],"image":{"id":850703190,"alt":null,"position":1,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/850703190","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]}},{"id":921728736,"title":"IPod Touch 8GB","body_html":"

The iPod Touch has the iPhone's multi-touch interface, with a physical home button off the touch screen. The home screen has a list of buttons for the available applications.

","vendor":"Apple","product_type":"Cult Products","created_at":"2024-09-25T14:24:08-04:00","handle":"ipod-touch","updated_at":"2024-09-25T14:24:08-04:00","published_at":"2008-09-25T20:00:00-04:00","template_suffix":null,"published_scope":"web","tags":"","status":"active","admin_graphql_api_id":"gid://shopify/Product/921728736","variants":[{"id":447654529,"product_id":921728736,"title":"Black","price":"199.00","position":1,"inventory_policy":"continue","compare_at_price":null,"option1":"Black","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_black","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2009BLACK","weight":1.25,"weight_unit":"lb","inventory_item_id":447654529,"inventory_quantity":13,"old_inventory_quantity":13,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/447654529","image_id":null}],"options":[{"id":891236591,"product_id":921728736,"name":"Title","position":1,"values":["Black"]}],"images":[],"image":null}]} ``` ##### Retrieve all products after the specified ID Request: ``` GET /admin/api/unstable/products.json ``` Response: ``` HTTP/1.1 200 OK {"products":[{"id":921728736,"title":"IPod Touch 8GB","body_html":"

The iPod Touch has the iPhone's multi-touch interface, with a physical home button off the touch screen. The home screen has a list of buttons for the available applications.

","vendor":"Apple","product_type":"Cult Products","created_at":"2024-09-25T14:24:08-04:00","handle":"ipod-touch","updated_at":"2024-09-25T14:24:08-04:00","published_at":"2008-09-25T20:00:00-04:00","template_suffix":null,"published_scope":"web","tags":"","status":"active","admin_graphql_api_id":"gid://shopify/Product/921728736","variants":[{"id":447654529,"product_id":921728736,"title":"Black","price":"199.00","position":1,"inventory_policy":"continue","compare_at_price":null,"option1":"Black","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_black","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2009BLACK","weight":1.25,"weight_unit":"lb","inventory_item_id":447654529,"inventory_quantity":13,"old_inventory_quantity":13,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/447654529","image_id":null}],"options":[{"id":891236591,"product_id":921728736,"name":"Title","position":1,"values":["Black"]}],"images":[],"image":null}]} ``` ##### Retrieve all products that belong to a certain collection Request: ``` GET /admin/api/unstable/products.json ``` Response: ``` HTTP/1.1 200 OK {"products":[{"id":632910392,"title":"IPod Nano - 8GB","body_html":"

It's the small iPod with one very big idea: Video. Now the world's most popular music player, available in 4GB and 8GB models, lets you enjoy TV shows, movies, video podcasts, and more. The larger, brighter display means amazing picture quality. In six eye-catching colors, iPod nano is stunning all around. And with models starting at just $149, little speaks volumes.

","vendor":"Apple","product_type":"Cult Products","created_at":"2024-09-25T14:24:08-04:00","handle":"ipod-nano","updated_at":"2024-09-25T14:24:08-04:00","published_at":"2007-12-31T19:00:00-05:00","template_suffix":null,"published_scope":"web","tags":"Emotive, Flash Memory, MP3, Music","status":"active","admin_graphql_api_id":"gid://shopify/Product/632910392","variants":[{"id":808950810,"product_id":632910392,"title":"Pink","price":"199.00","position":1,"inventory_policy":"continue","compare_at_price":null,"option1":"Pink","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_pink","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008PINK","weight":1.25,"weight_unit":"lb","inventory_item_id":808950810,"inventory_quantity":10,"old_inventory_quantity":10,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/808950810","image_id":562641783},{"id":49148385,"product_id":632910392,"title":"Red","price":"199.00","position":2,"inventory_policy":"continue","compare_at_price":null,"option1":"Red","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_red","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008RED","weight":1.25,"weight_unit":"lb","inventory_item_id":49148385,"inventory_quantity":20,"old_inventory_quantity":20,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/49148385","image_id":null},{"id":39072856,"product_id":632910392,"title":"Green","price":"199.00","position":3,"inventory_policy":"continue","compare_at_price":null,"option1":"Green","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_green","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008GREEN","weight":1.25,"weight_unit":"lb","inventory_item_id":39072856,"inventory_quantity":30,"old_inventory_quantity":30,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/39072856","image_id":null},{"id":457924702,"product_id":632910392,"title":"Black","price":"199.00","position":4,"inventory_policy":"continue","compare_at_price":null,"option1":"Black","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_black","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008BLACK","weight":1.25,"weight_unit":"lb","inventory_item_id":457924702,"inventory_quantity":40,"old_inventory_quantity":40,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/457924702","image_id":null}],"options":[{"id":594680422,"product_id":632910392,"name":"Color","position":1,"values":["Pink","Red","Green","Black"]}],"images":[{"id":850703190,"alt":null,"position":1,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/850703190","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]},{"id":562641783,"alt":null,"position":2,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/562641783","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano-2.png?v=1727288648","variant_ids":[808950810]},{"id":378407906,"alt":null,"position":3,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/378407906","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]}],"image":{"id":850703190,"alt":null,"position":1,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/850703190","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]}}]} ``` ##### Retrieve all products with prices in selected presentment currencies Request: ``` GET /admin/api/unstable/products.json ``` Response: ``` HTTP/1.1 200 OK {"products":[{"id":632910392,"title":"IPod Nano - 8GB","body_html":"

It's the small iPod with one very big idea: Video. Now the world's most popular music player, available in 4GB and 8GB models, lets you enjoy TV shows, movies, video podcasts, and more. The larger, brighter display means amazing picture quality. In six eye-catching colors, iPod nano is stunning all around. And with models starting at just $149, little speaks volumes.

","vendor":"Apple","product_type":"Cult Products","created_at":"2024-09-25T14:24:08-04:00","handle":"ipod-nano","updated_at":"2024-09-25T14:24:08-04:00","published_at":"2007-12-31T19:00:00-05:00","template_suffix":null,"published_scope":"web","tags":"Emotive, Flash Memory, MP3, Music","status":"active","admin_graphql_api_id":"gid://shopify/Product/632910392","variants":[{"id":808950810,"product_id":632910392,"title":"Pink","price":"199.00","position":1,"inventory_policy":"continue","compare_at_price":null,"option1":"Pink","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_pink","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008PINK","weight":1.25,"weight_unit":"lb","inventory_item_id":808950810,"inventory_quantity":10,"old_inventory_quantity":10,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/808950810","image_id":562641783},{"id":49148385,"product_id":632910392,"title":"Red","price":"199.00","position":2,"inventory_policy":"continue","compare_at_price":null,"option1":"Red","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_red","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008RED","weight":1.25,"weight_unit":"lb","inventory_item_id":49148385,"inventory_quantity":20,"old_inventory_quantity":20,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/49148385","image_id":null},{"id":39072856,"product_id":632910392,"title":"Green","price":"199.00","position":3,"inventory_policy":"continue","compare_at_price":null,"option1":"Green","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_green","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008GREEN","weight":1.25,"weight_unit":"lb","inventory_item_id":39072856,"inventory_quantity":30,"old_inventory_quantity":30,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/39072856","image_id":null},{"id":457924702,"product_id":632910392,"title":"Black","price":"199.00","position":4,"inventory_policy":"continue","compare_at_price":null,"option1":"Black","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_black","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008BLACK","weight":1.25,"weight_unit":"lb","inventory_item_id":457924702,"inventory_quantity":40,"old_inventory_quantity":40,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/457924702","image_id":null}],"options":[{"id":594680422,"product_id":632910392,"name":"Color","position":1,"values":["Pink","Red","Green","Black"]}],"images":[{"id":850703190,"alt":null,"position":1,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/850703190","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]},{"id":562641783,"alt":null,"position":2,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/562641783","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano-2.png?v=1727288648","variant_ids":[808950810]},{"id":378407906,"alt":null,"position":3,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/378407906","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]}],"image":{"id":850703190,"alt":null,"position":1,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/850703190","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]}},{"id":921728736,"title":"IPod Touch 8GB","body_html":"

The iPod Touch has the iPhone's multi-touch interface, with a physical home button off the touch screen. The home screen has a list of buttons for the available applications.

","vendor":"Apple","product_type":"Cult Products","created_at":"2024-09-25T14:24:08-04:00","handle":"ipod-touch","updated_at":"2024-09-25T14:24:08-04:00","published_at":"2008-09-25T20:00:00-04:00","template_suffix":null,"published_scope":"web","tags":"","status":"active","admin_graphql_api_id":"gid://shopify/Product/921728736","variants":[{"id":447654529,"product_id":921728736,"title":"Black","price":"199.00","position":1,"inventory_policy":"continue","compare_at_price":null,"option1":"Black","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_black","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2009BLACK","weight":1.25,"weight_unit":"lb","inventory_item_id":447654529,"inventory_quantity":13,"old_inventory_quantity":13,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/447654529","image_id":null}],"options":[{"id":891236591,"product_id":921728736,"name":"Title","position":1,"values":["Black"]}],"images":[],"image":null}]} ``` ##### Retrieve all products, showing only some attributes Request: ``` GET /admin/api/unstable/products.json ``` Response: ``` HTTP/1.1 200 OK {"products":[{"id":632910392,"title":"IPod Nano - 8GB","images":[{"id":850703190,"alt":null,"position":1,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/850703190","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]},{"id":562641783,"alt":null,"position":2,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/562641783","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano-2.png?v=1727288648","variant_ids":[808950810]},{"id":378407906,"alt":null,"position":3,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/378407906","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]}]},{"id":921728736,"title":"IPod Touch 8GB","images":[]}]} ``` ## Retrieve a count of products Retrieve a count of products. ### Endpoint /admin/api/#{api_version}/products/count.json (GET) ### Parameters * api_version (required): * collection_id: Return products by product collection ID. * created_at_max: Return products created before a specified date. (format: 2014-04-25T16:15:47-04:00) * created_at_min: Return products created after a specified date. (format: 2014-04-25T16:15:47-04:00) * product_type: Return products by product type. * published_at_max: Return products published before a specified date. (format: 2014-04-25T16:15:47-04:00) * published_at_min: Return products published after a specified date. (format: 2014-04-25T16:15:47-04:00) * published_status: Return products by their published status. * updated_at_max: Return products last updated before a specified date. (format: 2014-04-25T16:15:47-04:00) * updated_at_min: Return products last updated after a specified date. (format: 2014-04-25T16:15:47-04:00) * vendor: Return products by product vendor. ### Responses #### 200 Retrieve a count of products Examples: ##### Retrieve a count of all products Request: ``` GET /admin/api/unstable/products/count.json ``` Response: ``` HTTP/1.1 200 OK {"count":2} ``` ##### Retrieve a count of all products of a given collection Request: ``` GET /admin/api/unstable/products/count.json ``` Response: ``` HTTP/1.1 200 OK {"count":1} ``` ## Retrieve a single product Retrieve a single product. ### Endpoint /admin/api/#{api_version}/products/{product_id}.json (GET) ### Parameters * api_version (required): * product_id (required): * fields: A comma-separated list of fields to include in the response. ### Responses #### 200 Retrieve a single product Examples: ##### Retrieve a single product by ID Request: ``` GET /admin/api/unstable/products/632910392.json ``` Response: ``` HTTP/1.1 200 OK {"product":{"id":632910392,"title":"IPod Nano - 8GB","body_html":"

It's the small iPod with one very big idea: Video. Now the world's most popular music player, available in 4GB and 8GB models, lets you enjoy TV shows, movies, video podcasts, and more. The larger, brighter display means amazing picture quality. In six eye-catching colors, iPod nano is stunning all around. And with models starting at just $149, little speaks volumes.

","vendor":"Apple","product_type":"Cult Products","created_at":"2024-09-25T14:24:08-04:00","handle":"ipod-nano","updated_at":"2024-09-25T14:24:08-04:00","published_at":"2007-12-31T19:00:00-05:00","template_suffix":null,"published_scope":"web","tags":"Emotive, Flash Memory, MP3, Music","status":"active","admin_graphql_api_id":"gid://shopify/Product/632910392","variants":[{"id":808950810,"product_id":632910392,"title":"Pink","price":"199.00","position":1,"inventory_policy":"continue","compare_at_price":null,"option1":"Pink","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_pink","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008PINK","weight":1.25,"weight_unit":"lb","inventory_item_id":808950810,"inventory_quantity":10,"old_inventory_quantity":10,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/808950810","image_id":562641783},{"id":49148385,"product_id":632910392,"title":"Red","price":"199.00","position":2,"inventory_policy":"continue","compare_at_price":null,"option1":"Red","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_red","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008RED","weight":1.25,"weight_unit":"lb","inventory_item_id":49148385,"inventory_quantity":20,"old_inventory_quantity":20,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/49148385","image_id":null},{"id":39072856,"product_id":632910392,"title":"Green","price":"199.00","position":3,"inventory_policy":"continue","compare_at_price":null,"option1":"Green","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_green","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008GREEN","weight":1.25,"weight_unit":"lb","inventory_item_id":39072856,"inventory_quantity":30,"old_inventory_quantity":30,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/39072856","image_id":null},{"id":457924702,"product_id":632910392,"title":"Black","price":"199.00","position":4,"inventory_policy":"continue","compare_at_price":null,"option1":"Black","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_black","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008BLACK","weight":1.25,"weight_unit":"lb","inventory_item_id":457924702,"inventory_quantity":40,"old_inventory_quantity":40,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/457924702","image_id":null}],"options":[{"id":594680422,"product_id":632910392,"name":"Color","position":1,"values":["Pink","Red","Green","Black"]}],"images":[{"id":850703190,"alt":null,"position":1,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/850703190","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]},{"id":562641783,"alt":null,"position":2,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/562641783","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano-2.png?v=1727288648","variant_ids":[808950810]},{"id":378407906,"alt":null,"position":3,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/378407906","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]}],"image":{"id":850703190,"alt":null,"position":1,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/850703190","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]}}} ``` ##### Retrieve only particular fields from a single product Request: ``` GET /admin/api/unstable/products/632910392.json ``` Response: ``` HTTP/1.1 200 OK {"product":{"id":632910392,"title":"IPod Nano - 8GB","images":[{"id":850703190,"alt":null,"position":1,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/850703190","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]},{"id":562641783,"alt":null,"position":2,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/562641783","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano-2.png?v=1727288648","variant_ids":[808950810]},{"id":378407906,"alt":null,"position":3,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/378407906","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]}]}} ``` ## Updates a product

Update a product


### Endpoint /admin/api/#{api_version}/products/{product_id}.json (PUT) ### Parameters * api_version (required): * product_id (required): ### Responses #### 200 Updates a product Examples: ##### Add a metafield to an existing product Request: ``` PUT /admin/api/unstable/products/632910392.json {"product":{"id":632910392,"metafields":[{"key":"new","value":"newvalue","type":"single_line_text_field","namespace":"global"}]}} ``` Response: ``` HTTP/1.1 200 OK {"product":{"id":632910392,"title":"IPod Nano - 8GB","body_html":"

It's the small iPod with one very big idea: Video. Now the world's most popular music player, available in 4GB and 8GB models, lets you enjoy TV shows, movies, video podcasts, and more. The larger, brighter display means amazing picture quality. In six eye-catching colors, iPod nano is stunning all around. And with models starting at just $149, little speaks volumes.

","vendor":"Apple","product_type":"Cult Products","created_at":"2024-09-25T14:24:08-04:00","handle":"ipod-nano","updated_at":"2024-09-25T14:26:29-04:00","published_at":"2007-12-31T19:00:00-05:00","template_suffix":null,"published_scope":"web","tags":"Emotive, Flash Memory, MP3, Music","status":"active","admin_graphql_api_id":"gid://shopify/Product/632910392","variants":[{"id":808950810,"product_id":632910392,"title":"Pink","price":"199.00","position":1,"inventory_policy":"continue","compare_at_price":null,"option1":"Pink","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_pink","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008PINK","weight":1.25,"weight_unit":"lb","inventory_item_id":808950810,"inventory_quantity":10,"old_inventory_quantity":10,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/808950810","image_id":562641783},{"id":49148385,"product_id":632910392,"title":"Red","price":"199.00","position":2,"inventory_policy":"continue","compare_at_price":null,"option1":"Red","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_red","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008RED","weight":1.25,"weight_unit":"lb","inventory_item_id":49148385,"inventory_quantity":20,"old_inventory_quantity":20,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/49148385","image_id":null},{"id":39072856,"product_id":632910392,"title":"Green","price":"199.00","position":3,"inventory_policy":"continue","compare_at_price":null,"option1":"Green","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_green","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008GREEN","weight":1.25,"weight_unit":"lb","inventory_item_id":39072856,"inventory_quantity":30,"old_inventory_quantity":30,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/39072856","image_id":null},{"id":457924702,"product_id":632910392,"title":"Black","price":"199.00","position":4,"inventory_policy":"continue","compare_at_price":null,"option1":"Black","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_black","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008BLACK","weight":1.25,"weight_unit":"lb","inventory_item_id":457924702,"inventory_quantity":40,"old_inventory_quantity":40,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/457924702","image_id":null}],"options":[{"id":594680422,"product_id":632910392,"name":"Color","position":1,"values":["Pink","Red","Green","Black"]}],"images":[{"id":850703190,"alt":null,"position":1,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/850703190","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]},{"id":562641783,"alt":null,"position":2,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/562641783","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano-2.png?v=1727288648","variant_ids":[808950810]},{"id":378407906,"alt":null,"position":3,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/378407906","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]}],"image":{"id":850703190,"alt":null,"position":1,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/850703190","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]}}} ``` ##### Hide a published product by changing the published attribute to false Request: ``` PUT /admin/api/unstable/products/632910392.json {"product":{"id":632910392,"published":false}} ``` Response: ``` HTTP/1.1 200 OK {"product":{"id":632910392,"title":"IPod Nano - 8GB","body_html":"

It's the small iPod with one very big idea: Video. Now the world's most popular music player, available in 4GB and 8GB models, lets you enjoy TV shows, movies, video podcasts, and more. The larger, brighter display means amazing picture quality. In six eye-catching colors, iPod nano is stunning all around. And with models starting at just $149, little speaks volumes.

","vendor":"Apple","product_type":"Cult Products","created_at":"2024-09-25T14:24:08-04:00","handle":"ipod-nano","updated_at":"2024-09-25T14:25:50-04:00","published_at":null,"template_suffix":null,"published_scope":"web","tags":"Emotive, Flash Memory, MP3, Music","status":"active","admin_graphql_api_id":"gid://shopify/Product/632910392","variants":[{"id":808950810,"product_id":632910392,"title":"Pink","price":"199.00","position":1,"inventory_policy":"continue","compare_at_price":null,"option1":"Pink","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_pink","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008PINK","weight":1.25,"weight_unit":"lb","inventory_item_id":808950810,"inventory_quantity":10,"old_inventory_quantity":10,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/808950810","image_id":562641783},{"id":49148385,"product_id":632910392,"title":"Red","price":"199.00","position":2,"inventory_policy":"continue","compare_at_price":null,"option1":"Red","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_red","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008RED","weight":1.25,"weight_unit":"lb","inventory_item_id":49148385,"inventory_quantity":20,"old_inventory_quantity":20,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/49148385","image_id":null},{"id":39072856,"product_id":632910392,"title":"Green","price":"199.00","position":3,"inventory_policy":"continue","compare_at_price":null,"option1":"Green","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_green","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008GREEN","weight":1.25,"weight_unit":"lb","inventory_item_id":39072856,"inventory_quantity":30,"old_inventory_quantity":30,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/39072856","image_id":null},{"id":457924702,"product_id":632910392,"title":"Black","price":"199.00","position":4,"inventory_policy":"continue","compare_at_price":null,"option1":"Black","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_black","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008BLACK","weight":1.25,"weight_unit":"lb","inventory_item_id":457924702,"inventory_quantity":40,"old_inventory_quantity":40,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/457924702","image_id":null}],"options":[{"id":594680422,"product_id":632910392,"name":"Color","position":1,"values":["Pink","Red","Green","Black"]}],"images":[{"id":850703190,"alt":null,"position":1,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/850703190","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]},{"id":562641783,"alt":null,"position":2,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/562641783","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano-2.png?v=1727288648","variant_ids":[808950810]},{"id":378407906,"alt":null,"position":3,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/378407906","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]}],"image":{"id":850703190,"alt":null,"position":1,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/850703190","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]}}} ``` ##### Show a hidden product by changing the published attribute to true Request: ``` PUT /admin/api/unstable/products/632910392.json {"product":{"id":632910392,"published":true}} ``` Response: ``` HTTP/1.1 200 OK {"product":{"id":632910392,"title":"IPod Nano - 8GB","body_html":"

It's the small iPod with one very big idea: Video. Now the world's most popular music player, available in 4GB and 8GB models, lets you enjoy TV shows, movies, video podcasts, and more. The larger, brighter display means amazing picture quality. In six eye-catching colors, iPod nano is stunning all around. And with models starting at just $149, little speaks volumes.

","vendor":"Apple","product_type":"Cult Products","created_at":"2024-09-25T14:24:08-04:00","handle":"ipod-nano","updated_at":"2024-09-25T14:25:44-04:00","published_at":"2024-09-25T14:25:44-04:00","template_suffix":null,"published_scope":"web","tags":"Emotive, Flash Memory, MP3, Music","status":"active","admin_graphql_api_id":"gid://shopify/Product/632910392","variants":[{"id":808950810,"product_id":632910392,"title":"Pink","price":"199.00","position":1,"inventory_policy":"continue","compare_at_price":null,"option1":"Pink","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_pink","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008PINK","weight":1.25,"weight_unit":"lb","inventory_item_id":808950810,"inventory_quantity":10,"old_inventory_quantity":10,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/808950810","image_id":562641783},{"id":49148385,"product_id":632910392,"title":"Red","price":"199.00","position":2,"inventory_policy":"continue","compare_at_price":null,"option1":"Red","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_red","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008RED","weight":1.25,"weight_unit":"lb","inventory_item_id":49148385,"inventory_quantity":20,"old_inventory_quantity":20,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/49148385","image_id":null},{"id":39072856,"product_id":632910392,"title":"Green","price":"199.00","position":3,"inventory_policy":"continue","compare_at_price":null,"option1":"Green","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_green","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008GREEN","weight":1.25,"weight_unit":"lb","inventory_item_id":39072856,"inventory_quantity":30,"old_inventory_quantity":30,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/39072856","image_id":null},{"id":457924702,"product_id":632910392,"title":"Black","price":"199.00","position":4,"inventory_policy":"continue","compare_at_price":null,"option1":"Black","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_black","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008BLACK","weight":1.25,"weight_unit":"lb","inventory_item_id":457924702,"inventory_quantity":40,"old_inventory_quantity":40,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/457924702","image_id":null}],"options":[{"id":594680422,"product_id":632910392,"name":"Color","position":1,"values":["Pink","Red","Green","Black"]}],"images":[{"id":850703190,"alt":null,"position":1,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/850703190","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]},{"id":562641783,"alt":null,"position":2,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/562641783","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano-2.png?v=1727288648","variant_ids":[808950810]},{"id":378407906,"alt":null,"position":3,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/378407906","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]}],"image":{"id":850703190,"alt":null,"position":1,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/850703190","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]}}} ``` ##### Update a product and one of its variants Request: ``` PUT /admin/api/unstable/products/632910392.json {"product":{"id":632910392,"title":"Updated Product Title","variants":[{"id":808950810,"price":"2000.00","sku":"Updating the Product SKU"},{"id":49148385},{"id":39072856},{"id":457924702}]}} ``` Response: ``` HTTP/1.1 200 OK {"product":{"id":632910392,"title":"Updated Product Title","body_html":"

It's the small iPod with one very big idea: Video. Now the world's most popular music player, available in 4GB and 8GB models, lets you enjoy TV shows, movies, video podcasts, and more. The larger, brighter display means amazing picture quality. In six eye-catching colors, iPod nano is stunning all around. And with models starting at just $149, little speaks volumes.

","vendor":"Apple","product_type":"Cult Products","created_at":"2024-09-25T14:24:08-04:00","handle":"ipod-nano","updated_at":"2024-09-25T14:26:05-04:00","published_at":"2007-12-31T19:00:00-05:00","template_suffix":null,"published_scope":"web","tags":"Emotive, Flash Memory, MP3, Music","status":"active","admin_graphql_api_id":"gid://shopify/Product/632910392","variants":[{"id":808950810,"product_id":632910392,"title":"Pink","price":"2000.00","position":1,"inventory_policy":"continue","compare_at_price":null,"option1":"Pink","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:26:05-04:00","taxable":true,"barcode":"1234_pink","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"Updating the Product SKU","weight":1.25,"weight_unit":"lb","inventory_item_id":808950810,"inventory_quantity":10,"old_inventory_quantity":10,"presentment_prices":[{"price":{"amount":"2000.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/808950810","image_id":562641783},{"id":49148385,"product_id":632910392,"title":"Red","price":"199.00","position":2,"inventory_policy":"continue","compare_at_price":null,"option1":"Red","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_red","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008RED","weight":1.25,"weight_unit":"lb","inventory_item_id":49148385,"inventory_quantity":20,"old_inventory_quantity":20,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/49148385","image_id":null},{"id":39072856,"product_id":632910392,"title":"Green","price":"199.00","position":3,"inventory_policy":"continue","compare_at_price":null,"option1":"Green","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_green","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008GREEN","weight":1.25,"weight_unit":"lb","inventory_item_id":39072856,"inventory_quantity":30,"old_inventory_quantity":30,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/39072856","image_id":null},{"id":457924702,"product_id":632910392,"title":"Black","price":"199.00","position":4,"inventory_policy":"continue","compare_at_price":null,"option1":"Black","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_black","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008BLACK","weight":1.25,"weight_unit":"lb","inventory_item_id":457924702,"inventory_quantity":40,"old_inventory_quantity":40,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/457924702","image_id":null}],"options":[{"id":594680422,"product_id":632910392,"name":"Color","position":1,"values":["Pink","Red","Green","Black"]}],"images":[{"id":850703190,"alt":null,"position":1,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/850703190","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]},{"id":562641783,"alt":null,"position":2,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/562641783","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano-2.png?v=1727288648","variant_ids":[808950810]},{"id":378407906,"alt":null,"position":3,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/378407906","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]}],"image":{"id":850703190,"alt":null,"position":1,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/850703190","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]}}} ``` ##### Update a product by adding a new product image Request: ``` PUT /admin/api/unstable/products/632910392.json {"product":{"id":632910392,"images":[{"id":850703190},{"id":562641783},{"id":378407906},{"src":"http://example.com/rails_logo.gif"}]}} ``` Response: ``` HTTP/1.1 200 OK {"product":{"id":632910392,"title":"IPod Nano - 8GB","body_html":"

It's the small iPod with one very big idea: Video. Now the world's most popular music player, available in 4GB and 8GB models, lets you enjoy TV shows, movies, video podcasts, and more. The larger, brighter display means amazing picture quality. In six eye-catching colors, iPod nano is stunning all around. And with models starting at just $149, little speaks volumes.

","vendor":"Apple","product_type":"Cult Products","created_at":"2024-09-25T14:24:08-04:00","handle":"ipod-nano","updated_at":"2024-09-25T14:26:32-04:00","published_at":"2007-12-31T19:00:00-05:00","template_suffix":null,"published_scope":"web","tags":"Emotive, Flash Memory, MP3, Music","status":"active","admin_graphql_api_id":"gid://shopify/Product/632910392","variants":[{"id":808950810,"product_id":632910392,"title":"Pink","price":"199.00","position":1,"inventory_policy":"continue","compare_at_price":null,"option1":"Pink","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_pink","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008PINK","weight":1.25,"weight_unit":"lb","inventory_item_id":808950810,"inventory_quantity":10,"old_inventory_quantity":10,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/808950810","image_id":562641783},{"id":49148385,"product_id":632910392,"title":"Red","price":"199.00","position":2,"inventory_policy":"continue","compare_at_price":null,"option1":"Red","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_red","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008RED","weight":1.25,"weight_unit":"lb","inventory_item_id":49148385,"inventory_quantity":20,"old_inventory_quantity":20,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/49148385","image_id":null},{"id":39072856,"product_id":632910392,"title":"Green","price":"199.00","position":3,"inventory_policy":"continue","compare_at_price":null,"option1":"Green","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_green","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008GREEN","weight":1.25,"weight_unit":"lb","inventory_item_id":39072856,"inventory_quantity":30,"old_inventory_quantity":30,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/39072856","image_id":null},{"id":457924702,"product_id":632910392,"title":"Black","price":"199.00","position":4,"inventory_policy":"continue","compare_at_price":null,"option1":"Black","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_black","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008BLACK","weight":1.25,"weight_unit":"lb","inventory_item_id":457924702,"inventory_quantity":40,"old_inventory_quantity":40,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/457924702","image_id":null}],"options":[{"id":594680422,"product_id":632910392,"name":"Color","position":1,"values":["Pink","Red","Green","Black"]}],"images":[{"id":850703190,"alt":null,"position":1,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/850703190","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]},{"id":562641783,"alt":null,"position":2,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/562641783","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano-2.png?v=1727288648","variant_ids":[808950810]},{"id":378407906,"alt":null,"position":3,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/378407906","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]},{"id":1001473900,"alt":null,"position":4,"product_id":632910392,"created_at":"2024-09-25T14:26:32-04:00","updated_at":"2024-09-25T14:26:32-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/1001473900","width":110,"height":140,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/files/rails_logo20240925-78841-b94xlf.gif?v=1727288792","variant_ids":[]}],"image":{"id":850703190,"alt":null,"position":1,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/850703190","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]}}} ``` ##### Update a product by clearing product images Request: ``` PUT /admin/api/unstable/products/632910392.json {"product":{"id":632910392,"images":[]}} ``` Response: ``` HTTP/1.1 200 OK {"product":{"id":632910392,"title":"IPod Nano - 8GB","body_html":"

It's the small iPod with one very big idea: Video. Now the world's most popular music player, available in 4GB and 8GB models, lets you enjoy TV shows, movies, video podcasts, and more. The larger, brighter display means amazing picture quality. In six eye-catching colors, iPod nano is stunning all around. And with models starting at just $149, little speaks volumes.

","vendor":"Apple","product_type":"Cult Products","created_at":"2024-09-25T14:24:08-04:00","handle":"ipod-nano","updated_at":"2024-09-25T14:25:56-04:00","published_at":"2007-12-31T19:00:00-05:00","template_suffix":null,"published_scope":"web","tags":"Emotive, Flash Memory, MP3, Music","status":"active","admin_graphql_api_id":"gid://shopify/Product/632910392","variants":[{"id":808950810,"product_id":632910392,"title":"Pink","price":"199.00","position":1,"inventory_policy":"continue","compare_at_price":null,"option1":"Pink","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:25:56-04:00","taxable":true,"barcode":"1234_pink","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008PINK","weight":1.25,"weight_unit":"lb","inventory_item_id":808950810,"inventory_quantity":10,"old_inventory_quantity":10,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/808950810","image_id":null},{"id":49148385,"product_id":632910392,"title":"Red","price":"199.00","position":2,"inventory_policy":"continue","compare_at_price":null,"option1":"Red","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_red","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008RED","weight":1.25,"weight_unit":"lb","inventory_item_id":49148385,"inventory_quantity":20,"old_inventory_quantity":20,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/49148385","image_id":null},{"id":39072856,"product_id":632910392,"title":"Green","price":"199.00","position":3,"inventory_policy":"continue","compare_at_price":null,"option1":"Green","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_green","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008GREEN","weight":1.25,"weight_unit":"lb","inventory_item_id":39072856,"inventory_quantity":30,"old_inventory_quantity":30,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/39072856","image_id":null},{"id":457924702,"product_id":632910392,"title":"Black","price":"199.00","position":4,"inventory_policy":"continue","compare_at_price":null,"option1":"Black","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_black","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008BLACK","weight":1.25,"weight_unit":"lb","inventory_item_id":457924702,"inventory_quantity":40,"old_inventory_quantity":40,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/457924702","image_id":null}],"options":[{"id":594680422,"product_id":632910392,"name":"Color","position":1,"values":["Pink","Red","Green","Black"]}],"images":[],"image":null}} ``` ##### Update a product by reordering the product images Request: ``` PUT /admin/api/unstable/products/632910392.json {"product":{"id":632910392,"images":[{"id":850703190,"position":3},{"id":562641783,"position":2},{"id":378407906,"position":1}]}} ``` Response: ``` HTTP/1.1 200 OK {"product":{"id":632910392,"title":"IPod Nano - 8GB","body_html":"

It's the small iPod with one very big idea: Video. Now the world's most popular music player, available in 4GB and 8GB models, lets you enjoy TV shows, movies, video podcasts, and more. The larger, brighter display means amazing picture quality. In six eye-catching colors, iPod nano is stunning all around. And with models starting at just $149, little speaks volumes.

","vendor":"Apple","product_type":"Cult Products","created_at":"2024-09-25T14:24:08-04:00","handle":"ipod-nano","updated_at":"2024-09-25T14:25:55-04:00","published_at":"2007-12-31T19:00:00-05:00","template_suffix":null,"published_scope":"web","tags":"Emotive, Flash Memory, MP3, Music","status":"active","admin_graphql_api_id":"gid://shopify/Product/632910392","variants":[{"id":808950810,"product_id":632910392,"title":"Pink","price":"199.00","position":1,"inventory_policy":"continue","compare_at_price":null,"option1":"Pink","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_pink","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008PINK","weight":1.25,"weight_unit":"lb","inventory_item_id":808950810,"inventory_quantity":10,"old_inventory_quantity":10,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/808950810","image_id":562641783},{"id":49148385,"product_id":632910392,"title":"Red","price":"199.00","position":2,"inventory_policy":"continue","compare_at_price":null,"option1":"Red","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_red","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008RED","weight":1.25,"weight_unit":"lb","inventory_item_id":49148385,"inventory_quantity":20,"old_inventory_quantity":20,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/49148385","image_id":null},{"id":39072856,"product_id":632910392,"title":"Green","price":"199.00","position":3,"inventory_policy":"continue","compare_at_price":null,"option1":"Green","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_green","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008GREEN","weight":1.25,"weight_unit":"lb","inventory_item_id":39072856,"inventory_quantity":30,"old_inventory_quantity":30,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/39072856","image_id":null},{"id":457924702,"product_id":632910392,"title":"Black","price":"199.00","position":4,"inventory_policy":"continue","compare_at_price":null,"option1":"Black","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_black","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008BLACK","weight":1.25,"weight_unit":"lb","inventory_item_id":457924702,"inventory_quantity":40,"old_inventory_quantity":40,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/457924702","image_id":null}],"options":[{"id":594680422,"product_id":632910392,"name":"Color","position":1,"values":["Pink","Red","Green","Black"]}],"images":[{"id":378407906,"alt":null,"position":1,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:25:55-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/378407906","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]},{"id":850703190,"alt":null,"position":2,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/850703190","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]},{"id":562641783,"alt":null,"position":3,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/562641783","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano-2.png?v=1727288648","variant_ids":[808950810]}],"image":{"id":378407906,"alt":null,"position":1,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:25:55-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/378407906","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]}}} ``` ##### Update a product by reordering the product variants Request: ``` PUT /admin/api/unstable/products/632910392.json {"product":{"id":632910392,"variants":[{"id":457924702},{"id":39072856},{"id":49148385},{"id":808950810}]}} ``` Response: ``` HTTP/1.1 200 OK {"product":{"id":632910392,"title":"IPod Nano - 8GB","body_html":"

It's the small iPod with one very big idea: Video. Now the world's most popular music player, available in 4GB and 8GB models, lets you enjoy TV shows, movies, video podcasts, and more. The larger, brighter display means amazing picture quality. In six eye-catching colors, iPod nano is stunning all around. And with models starting at just $149, little speaks volumes.

","vendor":"Apple","product_type":"Cult Products","created_at":"2024-09-25T14:24:08-04:00","handle":"ipod-nano","updated_at":"2024-09-25T14:25:46-04:00","published_at":"2007-12-31T19:00:00-05:00","template_suffix":null,"published_scope":"web","tags":"Emotive, Flash Memory, MP3, Music","status":"active","admin_graphql_api_id":"gid://shopify/Product/632910392","variants":[{"id":457924702,"product_id":632910392,"title":"Black","price":"199.00","position":1,"inventory_policy":"continue","compare_at_price":null,"option1":"Black","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:25:45-04:00","taxable":true,"barcode":"1234_black","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008BLACK","weight":1.25,"weight_unit":"lb","inventory_item_id":457924702,"inventory_quantity":40,"old_inventory_quantity":40,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/457924702","image_id":null},{"id":39072856,"product_id":632910392,"title":"Green","price":"199.00","position":2,"inventory_policy":"continue","compare_at_price":null,"option1":"Green","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:25:45-04:00","taxable":true,"barcode":"1234_green","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008GREEN","weight":1.25,"weight_unit":"lb","inventory_item_id":39072856,"inventory_quantity":30,"old_inventory_quantity":30,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/39072856","image_id":null},{"id":49148385,"product_id":632910392,"title":"Red","price":"199.00","position":3,"inventory_policy":"continue","compare_at_price":null,"option1":"Red","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:25:45-04:00","taxable":true,"barcode":"1234_red","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008RED","weight":1.25,"weight_unit":"lb","inventory_item_id":49148385,"inventory_quantity":20,"old_inventory_quantity":20,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/49148385","image_id":null},{"id":808950810,"product_id":632910392,"title":"Pink","price":"199.00","position":4,"inventory_policy":"continue","compare_at_price":null,"option1":"Pink","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:25:45-04:00","taxable":true,"barcode":"1234_pink","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008PINK","weight":1.25,"weight_unit":"lb","inventory_item_id":808950810,"inventory_quantity":10,"old_inventory_quantity":10,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/808950810","image_id":562641783}],"options":[{"id":594680422,"product_id":632910392,"name":"Color","position":1,"values":["Black","Green","Red","Pink"]}],"images":[{"id":850703190,"alt":null,"position":1,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/850703190","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]},{"id":562641783,"alt":null,"position":2,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/562641783","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano-2.png?v=1727288648","variant_ids":[808950810]},{"id":378407906,"alt":null,"position":3,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/378407906","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]}],"image":{"id":850703190,"alt":null,"position":1,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/850703190","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]}}} ``` ##### Update a product's SEO title and description Request: ``` PUT /admin/api/unstable/products/632910392.json {"product":{"id":632910392,"metafields_global_title_tag":"Brand new title","metafields_global_description_tag":"Brand new description"}} ``` Response: ``` HTTP/1.1 200 OK {"product":{"id":632910392,"title":"IPod Nano - 8GB","body_html":"

It's the small iPod with one very big idea: Video. Now the world's most popular music player, available in 4GB and 8GB models, lets you enjoy TV shows, movies, video podcasts, and more. The larger, brighter display means amazing picture quality. In six eye-catching colors, iPod nano is stunning all around. And with models starting at just $149, little speaks volumes.

","vendor":"Apple","product_type":"Cult Products","created_at":"2024-09-25T14:24:08-04:00","handle":"ipod-nano","updated_at":"2024-09-25T14:24:08-04:00","published_at":"2007-12-31T19:00:00-05:00","template_suffix":null,"published_scope":"web","tags":"Emotive, Flash Memory, MP3, Music","status":"active","admin_graphql_api_id":"gid://shopify/Product/632910392","variants":[{"id":808950810,"product_id":632910392,"title":"Pink","price":"199.00","position":1,"inventory_policy":"continue","compare_at_price":null,"option1":"Pink","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_pink","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008PINK","weight":1.25,"weight_unit":"lb","inventory_item_id":808950810,"inventory_quantity":10,"old_inventory_quantity":10,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/808950810","image_id":562641783},{"id":49148385,"product_id":632910392,"title":"Red","price":"199.00","position":2,"inventory_policy":"continue","compare_at_price":null,"option1":"Red","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_red","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008RED","weight":1.25,"weight_unit":"lb","inventory_item_id":49148385,"inventory_quantity":20,"old_inventory_quantity":20,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/49148385","image_id":null},{"id":39072856,"product_id":632910392,"title":"Green","price":"199.00","position":3,"inventory_policy":"continue","compare_at_price":null,"option1":"Green","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_green","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008GREEN","weight":1.25,"weight_unit":"lb","inventory_item_id":39072856,"inventory_quantity":30,"old_inventory_quantity":30,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/39072856","image_id":null},{"id":457924702,"product_id":632910392,"title":"Black","price":"199.00","position":4,"inventory_policy":"continue","compare_at_price":null,"option1":"Black","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_black","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008BLACK","weight":1.25,"weight_unit":"lb","inventory_item_id":457924702,"inventory_quantity":40,"old_inventory_quantity":40,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/457924702","image_id":null}],"options":[{"id":594680422,"product_id":632910392,"name":"Color","position":1,"values":["Pink","Red","Green","Black"]}],"images":[{"id":850703190,"alt":null,"position":1,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/850703190","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]},{"id":562641783,"alt":null,"position":2,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/562641783","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano-2.png?v=1727288648","variant_ids":[808950810]},{"id":378407906,"alt":null,"position":3,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/378407906","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]}],"image":{"id":850703190,"alt":null,"position":1,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/850703190","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]}}} ``` ##### Update a product's status Request: ``` PUT /admin/api/unstable/products/632910392.json {"product":{"id":632910392,"status":"draft"}} ``` Response: ``` HTTP/1.1 200 OK {"product":{"id":632910392,"title":"IPod Nano - 8GB","body_html":"

It's the small iPod with one very big idea: Video. Now the world's most popular music player, available in 4GB and 8GB models, lets you enjoy TV shows, movies, video podcasts, and more. The larger, brighter display means amazing picture quality. In six eye-catching colors, iPod nano is stunning all around. And with models starting at just $149, little speaks volumes.

","vendor":"Apple","product_type":"Cult Products","created_at":"2024-09-25T14:24:08-04:00","handle":"ipod-nano","updated_at":"2024-09-25T14:26:23-04:00","published_at":null,"template_suffix":null,"published_scope":"web","tags":"Emotive, Flash Memory, MP3, Music","status":"draft","admin_graphql_api_id":"gid://shopify/Product/632910392","variants":[{"id":808950810,"product_id":632910392,"title":"Pink","price":"199.00","position":1,"inventory_policy":"continue","compare_at_price":null,"option1":"Pink","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_pink","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008PINK","weight":1.25,"weight_unit":"lb","inventory_item_id":808950810,"inventory_quantity":10,"old_inventory_quantity":10,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/808950810","image_id":562641783},{"id":49148385,"product_id":632910392,"title":"Red","price":"199.00","position":2,"inventory_policy":"continue","compare_at_price":null,"option1":"Red","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_red","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008RED","weight":1.25,"weight_unit":"lb","inventory_item_id":49148385,"inventory_quantity":20,"old_inventory_quantity":20,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/49148385","image_id":null},{"id":39072856,"product_id":632910392,"title":"Green","price":"199.00","position":3,"inventory_policy":"continue","compare_at_price":null,"option1":"Green","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_green","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008GREEN","weight":1.25,"weight_unit":"lb","inventory_item_id":39072856,"inventory_quantity":30,"old_inventory_quantity":30,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/39072856","image_id":null},{"id":457924702,"product_id":632910392,"title":"Black","price":"199.00","position":4,"inventory_policy":"continue","compare_at_price":null,"option1":"Black","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_black","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008BLACK","weight":1.25,"weight_unit":"lb","inventory_item_id":457924702,"inventory_quantity":40,"old_inventory_quantity":40,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/457924702","image_id":null}],"options":[{"id":594680422,"product_id":632910392,"name":"Color","position":1,"values":["Pink","Red","Green","Black"]}],"images":[{"id":850703190,"alt":null,"position":1,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/850703190","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]},{"id":562641783,"alt":null,"position":2,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/562641783","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano-2.png?v=1727288648","variant_ids":[808950810]},{"id":378407906,"alt":null,"position":3,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/378407906","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]}],"image":{"id":850703190,"alt":null,"position":1,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/850703190","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]}}} ``` ##### Update a product's tags Request: ``` PUT /admin/api/unstable/products/632910392.json {"product":{"id":632910392,"tags":"Barnes & Noble, John's Fav"}} ``` Response: ``` HTTP/1.1 200 OK {"product":{"id":632910392,"title":"IPod Nano - 8GB","body_html":"

It's the small iPod with one very big idea: Video. Now the world's most popular music player, available in 4GB and 8GB models, lets you enjoy TV shows, movies, video podcasts, and more. The larger, brighter display means amazing picture quality. In six eye-catching colors, iPod nano is stunning all around. And with models starting at just $149, little speaks volumes.

","vendor":"Apple","product_type":"Cult Products","created_at":"2024-09-25T14:24:08-04:00","handle":"ipod-nano","updated_at":"2024-09-25T14:25:35-04:00","published_at":"2007-12-31T19:00:00-05:00","template_suffix":null,"published_scope":"web","tags":"Barnes & Noble, John's Fav","status":"active","admin_graphql_api_id":"gid://shopify/Product/632910392","variants":[{"id":808950810,"product_id":632910392,"title":"Pink","price":"199.00","position":1,"inventory_policy":"continue","compare_at_price":null,"option1":"Pink","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_pink","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008PINK","weight":1.25,"weight_unit":"lb","inventory_item_id":808950810,"inventory_quantity":10,"old_inventory_quantity":10,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/808950810","image_id":562641783},{"id":49148385,"product_id":632910392,"title":"Red","price":"199.00","position":2,"inventory_policy":"continue","compare_at_price":null,"option1":"Red","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_red","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008RED","weight":1.25,"weight_unit":"lb","inventory_item_id":49148385,"inventory_quantity":20,"old_inventory_quantity":20,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/49148385","image_id":null},{"id":39072856,"product_id":632910392,"title":"Green","price":"199.00","position":3,"inventory_policy":"continue","compare_at_price":null,"option1":"Green","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_green","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008GREEN","weight":1.25,"weight_unit":"lb","inventory_item_id":39072856,"inventory_quantity":30,"old_inventory_quantity":30,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/39072856","image_id":null},{"id":457924702,"product_id":632910392,"title":"Black","price":"199.00","position":4,"inventory_policy":"continue","compare_at_price":null,"option1":"Black","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_black","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008BLACK","weight":1.25,"weight_unit":"lb","inventory_item_id":457924702,"inventory_quantity":40,"old_inventory_quantity":40,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/457924702","image_id":null}],"options":[{"id":594680422,"product_id":632910392,"name":"Color","position":1,"values":["Pink","Red","Green","Black"]}],"images":[{"id":850703190,"alt":null,"position":1,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/850703190","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]},{"id":562641783,"alt":null,"position":2,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/562641783","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano-2.png?v=1727288648","variant_ids":[808950810]},{"id":378407906,"alt":null,"position":3,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/378407906","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]}],"image":{"id":850703190,"alt":null,"position":1,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/850703190","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]}}} ``` ##### Update a product's title Request: ``` PUT /admin/api/unstable/products/632910392.json {"product":{"id":632910392,"title":"New product title"}} ``` Response: ``` HTTP/1.1 200 OK {"product":{"id":632910392,"title":"New product title","body_html":"

It's the small iPod with one very big idea: Video. Now the world's most popular music player, available in 4GB and 8GB models, lets you enjoy TV shows, movies, video podcasts, and more. The larger, brighter display means amazing picture quality. In six eye-catching colors, iPod nano is stunning all around. And with models starting at just $149, little speaks volumes.

","vendor":"Apple","product_type":"Cult Products","created_at":"2024-09-25T14:24:08-04:00","handle":"ipod-nano","updated_at":"2024-09-25T14:25:35-04:00","published_at":"2007-12-31T19:00:00-05:00","template_suffix":null,"published_scope":"web","tags":"Emotive, Flash Memory, MP3, Music","status":"active","admin_graphql_api_id":"gid://shopify/Product/632910392","variants":[{"id":808950810,"product_id":632910392,"title":"Pink","price":"199.00","position":1,"inventory_policy":"continue","compare_at_price":null,"option1":"Pink","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_pink","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008PINK","weight":1.25,"weight_unit":"lb","inventory_item_id":808950810,"inventory_quantity":10,"old_inventory_quantity":10,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/808950810","image_id":562641783},{"id":49148385,"product_id":632910392,"title":"Red","price":"199.00","position":2,"inventory_policy":"continue","compare_at_price":null,"option1":"Red","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_red","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008RED","weight":1.25,"weight_unit":"lb","inventory_item_id":49148385,"inventory_quantity":20,"old_inventory_quantity":20,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/49148385","image_id":null},{"id":39072856,"product_id":632910392,"title":"Green","price":"199.00","position":3,"inventory_policy":"continue","compare_at_price":null,"option1":"Green","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_green","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008GREEN","weight":1.25,"weight_unit":"lb","inventory_item_id":39072856,"inventory_quantity":30,"old_inventory_quantity":30,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/39072856","image_id":null},{"id":457924702,"product_id":632910392,"title":"Black","price":"199.00","position":4,"inventory_policy":"continue","compare_at_price":null,"option1":"Black","option2":null,"option3":null,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","taxable":true,"barcode":"1234_black","fulfillment_service":"manual","grams":567,"inventory_management":"shopify","requires_shipping":true,"sku":"IPOD2008BLACK","weight":1.25,"weight_unit":"lb","inventory_item_id":457924702,"inventory_quantity":40,"old_inventory_quantity":40,"presentment_prices":[{"price":{"amount":"199.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/457924702","image_id":null}],"options":[{"id":594680422,"product_id":632910392,"name":"Color","position":1,"values":["Pink","Red","Green","Black"]}],"images":[{"id":850703190,"alt":null,"position":1,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/850703190","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]},{"id":562641783,"alt":null,"position":2,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/562641783","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano-2.png?v=1727288648","variant_ids":[808950810]},{"id":378407906,"alt":null,"position":3,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/378407906","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]}],"image":{"id":850703190,"alt":null,"position":1,"product_id":632910392,"created_at":"2024-09-25T14:24:08-04:00","updated_at":"2024-09-25T14:24:08-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/850703190","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/products/ipod-nano.png?v=1727288648","variant_ids":[]}}} ``` ## Delete a product Deletes a product. ### Endpoint /admin/api/#{api_version}/products/{product_id}.json (DELETE) ### Parameters * api_version (required): * product_id (required): ### Responses #### 200 Delete a product Examples: ##### Delete a product along with all its variants and images Request: ``` DELETE /admin/api/unstable/products/632910392.json ``` Response: ``` HTTP/1.1 200 OK {} ``` ## Create a new product

Create a new product


### Endpoint /admin/api/#{api_version}/products.json (POST) ### Parameters * api_version (required): ### Responses #### 201 Create a new product Examples: ##### Create a new draft product Request: ``` POST /admin/api/unstable/products.json {"product":{"title":"Burton Custom Freestyle 151","body_html":"Good snowboard!","vendor":"Burton","product_type":"Snowboard","status":"draft"}} ``` Response: ``` HTTP/1.1 201 Created {"product":{"id":1072481047,"title":"Burton Custom Freestyle 151","body_html":"Good snowboard!","vendor":"Burton","product_type":"Snowboard","created_at":"2024-09-25T14:25:33-04:00","handle":"burton-custom-freestyle-151","updated_at":"2024-09-25T14:25:34-04:00","published_at":null,"template_suffix":null,"published_scope":"web","tags":"","status":"draft","admin_graphql_api_id":"gid://shopify/Product/1072481047","variants":[{"id":1070325022,"product_id":1072481047,"title":"Default Title","price":"0.00","position":1,"inventory_policy":"deny","compare_at_price":null,"option1":"Default Title","option2":null,"option3":null,"created_at":"2024-09-25T14:25:33-04:00","updated_at":"2024-09-25T14:25:33-04:00","taxable":true,"barcode":null,"fulfillment_service":"manual","grams":0,"inventory_management":null,"requires_shipping":true,"sku":"","weight":0.0,"weight_unit":"lb","inventory_item_id":1070325022,"inventory_quantity":0,"old_inventory_quantity":0,"presentment_prices":[{"price":{"amount":"0.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/1070325022","image_id":null}],"options":[{"id":1064576497,"product_id":1072481047,"name":"Title","position":1,"values":["Default Title"]}],"images":[],"image":null}} ``` ##### Create a new product with multiple product variants Request: ``` POST /admin/api/unstable/products.json {"product":{"title":"Burton Custom Freestyle 151","body_html":"Good snowboard!","vendor":"Burton","product_type":"Snowboard","variants":[{"option1":"First","price":"10.00","sku":"123"},{"option1":"Second","price":"20.00","sku":"123"}]}} ``` Response: ``` HTTP/1.1 201 Created {"product":{"id":1072481059,"title":"Burton Custom Freestyle 151","body_html":"Good snowboard!","vendor":"Burton","product_type":"Snowboard","created_at":"2024-09-25T14:26:11-04:00","handle":"burton-custom-freestyle-151","updated_at":"2024-09-25T14:26:11-04:00","published_at":"2024-09-25T14:26:11-04:00","template_suffix":null,"published_scope":"global","tags":"","status":"active","admin_graphql_api_id":"gid://shopify/Product/1072481059","variants":[{"id":1070325035,"product_id":1072481059,"title":"First","price":"10.00","position":1,"inventory_policy":"deny","compare_at_price":null,"option1":"First","option2":null,"option3":null,"created_at":"2024-09-25T14:26:11-04:00","updated_at":"2024-09-25T14:26:11-04:00","taxable":true,"barcode":null,"fulfillment_service":"manual","grams":0,"inventory_management":null,"requires_shipping":true,"sku":"123","weight":0.0,"weight_unit":"lb","inventory_item_id":1070325035,"inventory_quantity":0,"old_inventory_quantity":0,"presentment_prices":[{"price":{"amount":"10.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/1070325035","image_id":null},{"id":1070325036,"product_id":1072481059,"title":"Second","price":"20.00","position":2,"inventory_policy":"deny","compare_at_price":null,"option1":"Second","option2":null,"option3":null,"created_at":"2024-09-25T14:26:11-04:00","updated_at":"2024-09-25T14:26:11-04:00","taxable":true,"barcode":null,"fulfillment_service":"manual","grams":0,"inventory_management":null,"requires_shipping":true,"sku":"123","weight":0.0,"weight_unit":"lb","inventory_item_id":1070325036,"inventory_quantity":0,"old_inventory_quantity":0,"presentment_prices":[{"price":{"amount":"20.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/1070325036","image_id":null}],"options":[{"id":1064576519,"product_id":1072481059,"name":"Title","position":1,"values":["First","Second"]}],"images":[],"image":null}} ``` ##### Create a new product with multiple product variants and multiple options Request: ``` POST /admin/api/unstable/products.json {"product":{"title":"Burton Custom Freestyle 151","body_html":"Good snowboard!","vendor":"Burton","product_type":"Snowboard","variants":[{"option1":"Blue","option2":"155"},{"option1":"Black","option2":"159"}],"options":[{"name":"Color","values":["Blue","Black"]},{"name":"Size","values":["155","159"]}]}} ``` Response: ``` HTTP/1.1 201 Created {"product":{"id":1072481058,"title":"Burton Custom Freestyle 151","body_html":"Good snowboard!","vendor":"Burton","product_type":"Snowboard","created_at":"2024-09-25T14:26:03-04:00","handle":"burton-custom-freestyle-151","updated_at":"2024-09-25T14:26:03-04:00","published_at":"2024-09-25T14:26:03-04:00","template_suffix":null,"published_scope":"global","tags":"","status":"active","admin_graphql_api_id":"gid://shopify/Product/1072481058","variants":[{"id":1070325032,"product_id":1072481058,"title":"Blue / 155","price":"0.00","position":1,"inventory_policy":"deny","compare_at_price":null,"option1":"Blue","option2":"155","option3":null,"created_at":"2024-09-25T14:26:03-04:00","updated_at":"2024-09-25T14:26:03-04:00","taxable":true,"barcode":null,"fulfillment_service":"manual","grams":0,"inventory_management":null,"requires_shipping":true,"sku":"","weight":0.0,"weight_unit":"lb","inventory_item_id":1070325032,"inventory_quantity":0,"old_inventory_quantity":0,"presentment_prices":[{"price":{"amount":"0.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/1070325032","image_id":null},{"id":1070325033,"product_id":1072481058,"title":"Black / 159","price":"0.00","position":2,"inventory_policy":"deny","compare_at_price":null,"option1":"Black","option2":"159","option3":null,"created_at":"2024-09-25T14:26:03-04:00","updated_at":"2024-09-25T14:26:03-04:00","taxable":true,"barcode":null,"fulfillment_service":"manual","grams":0,"inventory_management":null,"requires_shipping":true,"sku":"","weight":0.0,"weight_unit":"lb","inventory_item_id":1070325033,"inventory_quantity":0,"old_inventory_quantity":0,"presentment_prices":[{"price":{"amount":"0.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/1070325033","image_id":null}],"options":[{"id":1064576517,"product_id":1072481058,"name":"Color","position":1,"values":["Blue","Black"]},{"id":1064576518,"product_id":1072481058,"name":"Size","position":2,"values":["155","159"]}],"images":[],"image":null}} ``` ##### Create a new product with the default product variant Request: ``` POST /admin/api/unstable/products.json {"product":{"title":"Burton Custom Freestyle 151","body_html":"Good snowboard!","vendor":"Burton","product_type":"Snowboard","tags":["Barnes & Noble","Big Air","John's Fav"]}} ``` Response: ``` HTTP/1.1 201 Created {"product":{"id":1072481057,"title":"Burton Custom Freestyle 151","body_html":"Good snowboard!","vendor":"Burton","product_type":"Snowboard","created_at":"2024-09-25T14:26:02-04:00","handle":"burton-custom-freestyle-151","updated_at":"2024-09-25T14:26:02-04:00","published_at":"2024-09-25T14:26:02-04:00","template_suffix":null,"published_scope":"global","tags":"Barnes & Noble, Big Air, John's Fav","status":"active","admin_graphql_api_id":"gid://shopify/Product/1072481057","variants":[{"id":1070325031,"product_id":1072481057,"title":"Default Title","price":"0.00","position":1,"inventory_policy":"deny","compare_at_price":null,"option1":"Default Title","option2":null,"option3":null,"created_at":"2024-09-25T14:26:02-04:00","updated_at":"2024-09-25T14:26:02-04:00","taxable":true,"barcode":null,"fulfillment_service":"manual","grams":0,"inventory_management":null,"requires_shipping":true,"sku":"","weight":0.0,"weight_unit":"lb","inventory_item_id":1070325031,"inventory_quantity":0,"old_inventory_quantity":0,"presentment_prices":[{"price":{"amount":"0.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/1070325031","image_id":null}],"options":[{"id":1064576516,"product_id":1072481057,"name":"Title","position":1,"values":["Default Title"]}],"images":[],"image":null}} ``` ##### Create a new product with the default variant and a product image that will be downloaded by Shopify Request: ``` POST /admin/api/unstable/products.json {"product":{"title":"Burton Custom Freestyle 151","body_html":"Good snowboard!","vendor":"Burton","product_type":"Snowboard","images":[{"src":"http://example.com/rails_logo.gif"}]}} ``` Response: ``` HTTP/1.1 201 Created {"product":{"id":1072481063,"title":"Burton Custom Freestyle 151","body_html":"Good snowboard!","vendor":"Burton","product_type":"Snowboard","created_at":"2024-09-25T14:26:27-04:00","handle":"burton-custom-freestyle-151","updated_at":"2024-09-25T14:26:28-04:00","published_at":"2024-09-25T14:26:27-04:00","template_suffix":null,"published_scope":"global","tags":"","status":"active","admin_graphql_api_id":"gid://shopify/Product/1072481063","variants":[{"id":1070325041,"product_id":1072481063,"title":"Default Title","price":"0.00","position":1,"inventory_policy":"deny","compare_at_price":null,"option1":"Default Title","option2":null,"option3":null,"created_at":"2024-09-25T14:26:27-04:00","updated_at":"2024-09-25T14:26:27-04:00","taxable":true,"barcode":null,"fulfillment_service":"manual","grams":0,"inventory_management":null,"requires_shipping":true,"sku":"","weight":0.0,"weight_unit":"lb","inventory_item_id":1070325041,"inventory_quantity":0,"old_inventory_quantity":0,"presentment_prices":[{"price":{"amount":"0.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/1070325041","image_id":null}],"options":[{"id":1064576523,"product_id":1072481063,"name":"Title","position":1,"values":["Default Title"]}],"images":[{"id":1001473899,"alt":null,"position":1,"product_id":1072481063,"created_at":"2024-09-25T14:26:27-04:00","updated_at":"2024-09-25T14:26:27-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/1001473899","width":110,"height":140,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/files/rails_logo20240925-78841-y3tjtc.gif?v=1727288787","variant_ids":[]}],"image":{"id":1001473899,"alt":null,"position":1,"product_id":1072481063,"created_at":"2024-09-25T14:26:27-04:00","updated_at":"2024-09-25T14:26:27-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/1001473899","width":110,"height":140,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/files/rails_logo20240925-78841-y3tjtc.gif?v=1727288787","variant_ids":[]}}} ``` ##### Create a new product with the default variant and base64 encoded image Request: ``` POST /admin/api/unstable/products.json {"product":{"title":"Burton Custom Freestyle 151","body_html":"Good snowboard!","vendor":"Burton","product_type":"Snowboard","images":[{"attachment":"R0lGODlhAQABAIAAAAAAAAAAACH5BAEAAAAALAAAAAABAAEAAAICRAEAOw==\n"}]}} ``` Response: ``` HTTP/1.1 201 Created {"product":{"id":1072481062,"title":"Burton Custom Freestyle 151","body_html":"Good snowboard!","vendor":"Burton","product_type":"Snowboard","created_at":"2024-09-25T14:26:21-04:00","handle":"burton-custom-freestyle-151","updated_at":"2024-09-25T14:26:22-04:00","published_at":"2024-09-25T14:26:21-04:00","template_suffix":null,"published_scope":"global","tags":"","status":"active","admin_graphql_api_id":"gid://shopify/Product/1072481062","variants":[{"id":1070325039,"product_id":1072481062,"title":"Default Title","price":"0.00","position":1,"inventory_policy":"deny","compare_at_price":null,"option1":"Default Title","option2":null,"option3":null,"created_at":"2024-09-25T14:26:21-04:00","updated_at":"2024-09-25T14:26:21-04:00","taxable":true,"barcode":null,"fulfillment_service":"manual","grams":0,"inventory_management":null,"requires_shipping":true,"sku":"","weight":0.0,"weight_unit":"lb","inventory_item_id":1070325039,"inventory_quantity":0,"old_inventory_quantity":0,"presentment_prices":[{"price":{"amount":"0.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/1070325039","image_id":null}],"options":[{"id":1064576522,"product_id":1072481062,"name":"Title","position":1,"values":["Default Title"]}],"images":[{"id":1001473898,"alt":null,"position":1,"product_id":1072481062,"created_at":"2024-09-25T14:26:21-04:00","updated_at":"2024-09-25T14:26:21-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/1001473898","width":1,"height":1,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/files/df3e567d6f16d040326c7a0ea29a4f41.gif?v=1727288781","variant_ids":[]}],"image":{"id":1001473898,"alt":null,"position":1,"product_id":1072481062,"created_at":"2024-09-25T14:26:21-04:00","updated_at":"2024-09-25T14:26:21-04:00","admin_graphql_api_id":"gid://shopify/ProductImage/1001473898","width":1,"height":1,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/files/df3e567d6f16d040326c7a0ea29a4f41.gif?v=1727288781","variant_ids":[]}}} ``` ##### Create a new unpublished product Request: ``` POST /admin/api/unstable/products.json {"product":{"title":"Burton Custom Freestyle 151","body_html":"Good snowboard!","vendor":"Burton","product_type":"Snowboard","published":false}} ``` Response: ``` HTTP/1.1 201 Created {"product":{"id":1072481053,"title":"Burton Custom Freestyle 151","body_html":"Good snowboard!","vendor":"Burton","product_type":"Snowboard","created_at":"2024-09-25T14:25:54-04:00","handle":"burton-custom-freestyle-151","updated_at":"2024-09-25T14:25:54-04:00","published_at":null,"template_suffix":null,"published_scope":"global","tags":"","status":"active","admin_graphql_api_id":"gid://shopify/Product/1072481053","variants":[{"id":1070325028,"product_id":1072481053,"title":"Default Title","price":"0.00","position":1,"inventory_policy":"deny","compare_at_price":null,"option1":"Default Title","option2":null,"option3":null,"created_at":"2024-09-25T14:25:54-04:00","updated_at":"2024-09-25T14:25:54-04:00","taxable":true,"barcode":null,"fulfillment_service":"manual","grams":0,"inventory_management":null,"requires_shipping":true,"sku":"","weight":0.0,"weight_unit":"lb","inventory_item_id":1070325028,"inventory_quantity":0,"old_inventory_quantity":0,"presentment_prices":[{"price":{"amount":"0.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/1070325028","image_id":null}],"options":[{"id":1064576510,"product_id":1072481053,"name":"Title","position":1,"values":["Default Title"]}],"images":[],"image":null}} ``` ##### Create a product with a metafield Request: ``` POST /admin/api/unstable/products.json {"product":{"title":"Burton Custom Freestyle 151","body_html":"Good snowboard!","vendor":"Burton","product_type":"Snowboard","metafields":[{"key":"new","value":"newvalue","type":"single_line_text_field","namespace":"global"}]}} ``` Response: ``` HTTP/1.1 201 Created {"product":{"id":1072481061,"title":"Burton Custom Freestyle 151","body_html":"Good snowboard!","vendor":"Burton","product_type":"Snowboard","created_at":"2024-09-25T14:26:19-04:00","handle":"burton-custom-freestyle-151","updated_at":"2024-09-25T14:26:19-04:00","published_at":"2024-09-25T14:26:19-04:00","template_suffix":null,"published_scope":"global","tags":"","status":"active","admin_graphql_api_id":"gid://shopify/Product/1072481061","variants":[{"id":1070325038,"product_id":1072481061,"title":"Default Title","price":"0.00","position":1,"inventory_policy":"deny","compare_at_price":null,"option1":"Default Title","option2":null,"option3":null,"created_at":"2024-09-25T14:26:19-04:00","updated_at":"2024-09-25T14:26:19-04:00","taxable":true,"barcode":null,"fulfillment_service":"manual","grams":0,"inventory_management":null,"requires_shipping":true,"sku":"","weight":0.0,"weight_unit":"lb","inventory_item_id":1070325038,"inventory_quantity":0,"old_inventory_quantity":0,"presentment_prices":[{"price":{"amount":"0.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/1070325038","image_id":null}],"options":[{"id":1064576521,"product_id":1072481061,"name":"Title","position":1,"values":["Default Title"]}],"images":[],"image":null}} ``` ##### Create a product with an SEO title and description Request: ``` POST /admin/api/unstable/products.json {"product":{"title":"Burton Custom Freestyle 151","body_html":"Good snowboard!","vendor":"Burton","product_type":"Snowboard","metafields_global_title_tag":"Product SEO Title","metafields_global_description_tag":"Product SEO Description"}} ``` Response: ``` HTTP/1.1 201 Created {"product":{"id":1072481060,"title":"Burton Custom Freestyle 151","body_html":"Good snowboard!","vendor":"Burton","product_type":"Snowboard","created_at":"2024-09-25T14:26:14-04:00","handle":"burton-custom-freestyle-151","updated_at":"2024-09-25T14:26:14-04:00","published_at":"2024-09-25T14:26:14-04:00","template_suffix":null,"published_scope":"global","tags":"","status":"active","admin_graphql_api_id":"gid://shopify/Product/1072481060","variants":[{"id":1070325037,"product_id":1072481060,"title":"Default Title","price":"0.00","position":1,"inventory_policy":"deny","compare_at_price":null,"option1":"Default Title","option2":null,"option3":null,"created_at":"2024-09-25T14:26:14-04:00","updated_at":"2024-09-25T14:26:14-04:00","taxable":true,"barcode":null,"fulfillment_service":"manual","grams":0,"inventory_management":null,"requires_shipping":true,"sku":"","weight":0.0,"weight_unit":"lb","inventory_item_id":1070325037,"inventory_quantity":0,"old_inventory_quantity":0,"presentment_prices":[{"price":{"amount":"0.00","currency_code":"USD"},"compare_at_price":null}],"admin_graphql_api_id":"gid://shopify/ProductVariant/1070325037","image_id":null}],"options":[{"id":1064576520,"product_id":1072481060,"name":"Title","position":1,"values":["Default Title"]}],"images":[],"image":null}} ``` #### 422 Create a new product Examples: ##### Creating a product without a title will return an error Request: ``` POST /admin/api/unstable/products.json {"product":{"body_html":"A mystery!"}} ``` Response: ``` HTTP/1.1 422 Unprocessable Entity {"errors":{"title":["can't be blank"]}} ```