Update Product

PATCH /wp-json/content-api/v1/product/

Updates an existing WooCommerce product.

Authentication

This endpoint requires a Bearer token in the Authorization header. To authenticate:

1. Go to Content API > Settings in your WordPress admin panel.
2. Set a secure token in the “Token” field and save it.
3. Include the token in your request header as follows:

Authorization: Bearer <your-token-here>

Replace <your-token-here> with the token you configured.

Parameters

Name	Type	Description	Required
product_id	integer	The ID of the product	Yes if no sku provided
sku	string	The SKU of the product	Yes if no product_id provided
upc	string	UPC or other identifier unique to this product using numbers and hyphens only (Requires 1.0.6)	No
weight	string	Weight of the product (Requires 1.0.7)	No
name	string	Product name	No
status	string	Status of product (publish, draft, ect) (Requires 1.0.5)	No
slug	string	Product slug	No
description	string	Product description	No
short_description	string	Short description	No
price	float	Regular price	No
sale_price	float	Sale price	No
map_price	float	MAP price of the product (Requires 1.0.4)	No
cost	float	Cost of the product (Requires 1.0.4)	No
stock_status	string	Stock status (e.g., “instock”)	No
manage_stock	bool	Pass true to manage stock or false otherwise. (Requires 1.0.9)	No
stock_quantity	integer	Stock quantity	No
tags	array	Product tags	No
categories	array	Product categories by ID or slug. Replaces current categories. (Requires 1.0.4)	No
featured_image	string	URL of featured image	No
images	array	Gallery image URLs	No
yoast	object	Yoast SEO metadata	No

Example Request Using Product ID

{
  "product_id": 123,
  "name": "Sunglasses",
  "slug": "sunglasses",
  "sku": "SUNGLASS-1",
  "upc": "123456-789",
  "weight": "10.59",
  "description": "Updated description",
  "short_description": "Updated short description",
  "price": 129.99,
  "sale_price": 89.99,
  "map_price": 79.99,
  "cost": 74.99,
  "stock_quantity": 22,
  "tags": ["test1", "test2"],
  "categories": ["test-1", "test-2"],
  "featured_image": "https://www.example.com/featured.jpg",
  "images": [
  "https://www.example.com/example1.jpg",
  "https://www.example.com/example2.jpg"
  ],
  "yoast": {
    "title": "SEO Title",
    "description": "SEO Description",
    "premium": {
    "social_appearance": {
      "title": "Facebook Title",
      "description": "Facebook Description",
      "image": "https://www.example.com/facebook.jpg"
    },
    "x": {
      "title": "Twitter Title",
      "description": "Twitter Description",
      "image": "https://www.example.com/twitter.jpg"
    }
  }
}

Example Response

{
  "success": true,
  "product_id": 123,
  "message": "Product updated successfully"
}

Example Request Using SKU

{
  "sku": "SUNGLASS-1",
  "name": "Sunglasses",
}

Example Response

{
  "success": true,
  "product_id": 123,
  "message": "Product updated successfully"
}

Possible Errors

Code	Message	Description	HTTP Status
not_authorized	Not Authorized	The provided Bearer token is invalid or does not match the configured token.	401
missing_identifier	Product ID or SKU is required	Neither a product ID nor SKU was provided in the request body.	400
product_id_invalid	Product ID is invalid	The provided product ID is not a valid numeric value.	400
sku_invalid	SKU is invalid	The provided SKU contains invalid characters or is not properly sanitized.	400
product_sku_exists	Product with provided SKU already exists	The provided product SKU exists.	400
upc_malformed	UPC must contain only numbers and hyphens	You have characters other than numbers and –	500
conflicting_identifiers	Both Product ID and SKU are provided. Please provide only one.	Both product ID and SKU were provided in the same request, which is not allowed.	400
product_not_found	Product not found	No product was found matching the provided product ID.	404
product_not_found	Product not found with provided SKU	No product was found matching the provided SKU.	404
slug_invalid	Invalid slug format	The provided slug is empty after sanitization.	400
slug_exists	Slug already in use by another product	The provided slug is already used by a different product.	400
update_failed	Failed to update product	An error occurred while saving the updated product data to the database.	500
media_upload_failed	[Error message from WordPress]	Failed to upload the featured image or gallery images to the media library (e.g., invalid URL, server error).	500
product_exception	An error occurred when attempting to update UPC. It may be in use, please check your trash.	Occurs typically when UPC or SKU is already in use.	500