MerchantHQ API
PUT /2024-09/products/{product}
Default

Update the specified product's information

Path parameters

  • product string(uuid) Required

    The UUID of the product

application/json

Body Required

  • sku string

    Stock Keeping Unit - unique identifier for the product within the merchant

    Maximum length is 255.

  • title string

    The title or name of the product

  • main_image_id string | null

    The UUID of the main product image

  • thumbnail_image_id string | null

    The UUID of the thumbnail product image

Responses

  • 204

    Empty response with no content

  • 401 application/json

    The request requires user authentication or the user is not authorized to access this resource.

    Hide response attribute Show response attribute object
    • message string
  • 403 application/json

    Forbidden - The user does not have permission to access this resource.

    Hide response attribute Show response attribute object
    • message string Required
  • 404 application/json

    The specified resource was not found

    Hide response attribute Show response attribute object
    • message string
PUT /2024-09/products/{product} 
curl \
 --request PUT 'https://app.merchanthq.com/api/2024-09/products/1e7f0a0f-b5a9-4d1a-a2d5-d0e0c2b1c3d4' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{"sku":"PROD-001","title":"Blue Widget","main_image_id":"2e8f0a0f-b5a9-4d1a-a2d5-d0e0c2b1c3d5","thumbnail_image_id":"3e9f0a0f-b5a9-4d1a-a2d5-d0e0c2b1c3d6"}'
Request examples 
{
  "sku": "PROD-001",
  "title": "Blue Widget",
  "main_image_id": "2e8f0a0f-b5a9-4d1a-a2d5-d0e0c2b1c3d5",
  "thumbnail_image_id": "3e9f0a0f-b5a9-4d1a-a2d5-d0e0c2b1c3d6"
}
Response examples (401) 
{
  "message": "Unauthorized"
}
Response examples (403) 
{
  "message": "This action is unauthorized."
}
Response examples (404) 
{
  "message": "Not found"
}