Products

The Products resource provides full CRUD for WooCommerce products.

Endpoints

Method	Path	Description
GET	/woo/products	List products
GET	/woo/products/{id}	Get product
POST	/woo/products	Create product
PUT / PATCH	/woo/products/{id}	Update product
DELETE	/woo/products/{id}	Delete product

List query parameters

Parameter	Type	Default	Description
fields	string	default set	Comma-separated field names
status	string|array	—	Filter by status (comma-separated)
type	string	—	Filter by product type
sku	string	—	Exact SKU match
search	string	—	Text search
stock_status	string	—	instock, outofstock, onbackorder
sort	string	-date_created	Sort field, prefix - for DESC
page	int	1	Page number
per_page	int	20	Items per page (max 100)

Allowed sort fields: date_created, date_modified, id, title, price

Available fields

List defaults: id, name, slug, status, type, sku, price, stock_status, date_created, date_modified

All fields: id, name, slug, status, type, sku, price, regular_price, sale_price, date_created, date_modified, catalog_visibility, description, short_description, stock_status, stock_quantity, manage_stock, virtual, downloadable, meta_data

Create / Update payload

{
  "name": "Premium Widget",
  "status": "publish",
  "type": "simple",
  "sku": "WDG-001",
  "regular_price": "29.99",
  "sale_price": "24.99",
  "description": "Full product description.",
  "short_description": "A premium widget.",
  "stock_status": "instock",
  "stock_quantity": 50,
  "manage_stock": true,
  "virtual": false,
  "downloadable": false,
  "catalog_visibility": "visible",
  "meta_data": [
    { "key": "brand", "value": "WidgetCo" }
  ]
}

Notes

• type is create-only. It cannot be changed after creation. Defaults to simple when omitted.
• Boolean fields (manage_stock, virtual, downloadable) accept booleans, integers (0/1), or strings ("true", "false", "yes", "no").
• stock_quantity accepts an integer or null.

v0.3.0 changes

• deleteMode ('force' default or 'trash') on the registrar controls whether DELETE permanently removes or trashes the product.
• Protected meta keys (_...) are not returned and not writable by default.