Update Product
curl --request PUT \
--url https://production-api.puppetvendors.com/products/{productId} \
--header 'x-access-token: <api-key>'import requests
url = "https://production-api.puppetvendors.com/products/{productId}"
headers = {"x-access-token": "<api-key>"}
response = requests.put(url, headers=headers)
print(response.text)const options = {method: 'PUT', headers: {'x-access-token': '<api-key>'}};
fetch('https://production-api.puppetvendors.com/products/{productId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://production-api.puppetvendors.com/products/{productId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_HTTPHEADER => [
"x-access-token: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://production-api.puppetvendors.com/products/{productId}"
req, _ := http.NewRequest("PUT", url, nil)
req.Header.Add("x-access-token", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://production-api.puppetvendors.com/products/{productId}")
.header("x-access-token", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://production-api.puppetvendors.com/products/{productId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["x-access-token"] = '<api-key>'
response = http.request(request)
puts response.read_bodyProducts
Update Product
Full product update via Shopify productSet mutation
PUT
/
products
/
{productId}
Update Product
curl --request PUT \
--url https://production-api.puppetvendors.com/products/{productId} \
--header 'x-access-token: <api-key>'import requests
url = "https://production-api.puppetvendors.com/products/{productId}"
headers = {"x-access-token": "<api-key>"}
response = requests.put(url, headers=headers)
print(response.text)const options = {method: 'PUT', headers: {'x-access-token': '<api-key>'}};
fetch('https://production-api.puppetvendors.com/products/{productId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://production-api.puppetvendors.com/products/{productId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_HTTPHEADER => [
"x-access-token: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://production-api.puppetvendors.com/products/{productId}"
req, _ := http.NewRequest("PUT", url, nil)
req.Header.Add("x-access-token", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://production-api.puppetvendors.com/products/{productId}")
.header("x-access-token", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://production-api.puppetvendors.com/products/{productId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["x-access-token"] = '<api-key>'
response = http.request(request)
puts response.read_bodyV2 Preview: this endpoint is part of the V2 API preview. Breaking changes may occur.
Overview
PUT /products/{productId}
Updates one of your own products via Shopify’s productSet mutation. productId can be a Shopify numeric id, a Shopify GID or a MongoDB ObjectId. Fields you leave out keep their current values.
variants, options, metafields and images replace the stored arrays. Send the full desired set.Path parameters
productIdstring required. Shopify numeric id, Shopify GID or MongoDB ObjectId of a product owned by your vendor.
Request body
title, descriptionHtml, productType, vendor, brandName, status (ACTIVE | DRAFT | ARCHIVED), handle, tags[], collections[], options[], variants[], metafields[], seo, category, templateSuffix, isDigital, plus:
images[](max 250): product images,{ "src": "<https URL>", "altText": "<optional>" }.medias[](max 250): downloadable files for digital products. Leave it out to keep the current files.descriptionHtml: send""to clear the description.vendorId(optional): if sent, it must be your own vendor id. Any other vendor returns403 FORBIDDEN“Vendor tokens can only assign products to their own vendor”. You can’t move a product to another vendor.
400 VALIDATION_ERROR with a hint. media → use images / medias; published → use status; description / body_html → use descriptionHtml.
Responses
| Status | When |
|---|---|
| 200 | Updated; data is the full product |
| 400 | VALIDATION_ERROR: invalid or unsupported field |
| 401 | Missing or invalid token |
| 403 | vendorId is not your vendor, or the token lacks product write scope |
| 404 | NOT_FOUND “Product not found” (not your product, or deleted) |
200 Updated
{
"success": true,
"data": {
"_id": "<id_4>",
"vendorStoreProductId": null,
"assignedVendors": [],
"tags": [
"vendor_Vendor-78"
],
"collections": [],
"variants": [
{
"id": "gid://shopify/ProductVariant/<redacted>",
"price": "19.61",
"sku": null,
"inventoryItem": {
"id": "gid://shopify/InventoryItem/<redacted>"
},
"selectedOptions": [
{
"name": "Color",
"value": "Red"
}
],
"metafields": {
"edges": []
},
"title": "Red"
}
],
"options": [
{
"id": "gid://shopify/ProductOption/<redacted>",
"name": "Color",
"position": 1,
"values": [
"Red"
]
}
],
"images": [],
"medias": [],
"shopifyMedias": [],
"status": "draft",
"metafields": [],
"giftCard": false,
"changes": [],
"deletedAt": null,
"healAttempts": 0,
"lastHealAt": null,
"shopId": "<id_2>",
"isDigital": false,
"handle": "test-product-1-a2db36",
"title": "Test Product 1",
"descriptionHtml": "Test Description",
"vendorId": "<id_3>",
"vendor": "Vendor-78",
"productType": "",
"updatedByPV": true,
"request": null,
"createdAt": "2026-09-15T06:19:18.450Z",
"updatedAt": "2026-10-21T10:36:54.334Z",
"totalInventory": 0,
"__v": 0,
"shopifyErrors": null,
"graphqlProductId": "gid://shopify/Product/<redacted>",
"productId": "<redacted>",
"publishedAt": "2026-09-15T06:45:03.119Z",
"brandName": "Vendor-78"
}
}
403 Another vendor
{ "success": false, "error": { "code": "FORBIDDEN", "message": "Vendor tokens can only assign products to their own vendor" } }
400 Old media field
{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Validation failed",
"errorId": "err_1792578578483_abc1234",
"details": [
{ "code": "unrecognized_keys", "keys": ["media"], "path": [],
"message": "Unsupported field(s): media (use images for product images, medias for digital files)" }
]
}
}
404
{ "success": false, "error": { "code": "NOT_FOUND", "message": "Product not found" } }
Examples
Update title, status and images
curl -X PUT "https://production-api.puppetvendors.com/products/507f1f77bcf86cd799439013" \
-H "x-access-token: $PV_VENDOR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"title": "Updated Product",
"status": "ACTIVE",
"images": [{ "src": "https://cdn.example.com/p.jpg", "altText": "Front" }]
}'
Update and tags
curl -X PUT "https://production-api.puppetvendors.com/products/507f1f77bcf86cd799439013" \
-H "x-access-token: $PV_VENDOR_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "title": "Updated Product Name", "tags": ["new-tag", "sale"] }'
Clear the description
curl -X PUT "https://production-api.puppetvendors.com/products/507f1f77bcf86cd799439013" \
-H "x-access-token: $PV_VENDOR_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "descriptionHtml": "" }'
Was this page helpful?