Update WooCommerce Order
woocommerce_update_orderUpdate an existing order's status, addresses, or customer note. Avoids altering line items to prevent accidental stock or total miscalculation.
Instructions
Update an existing order's status, addresses, or notes. To change line items, use the WooCommerce admin UI or pass a full 'line_items' array via a direct API call - this tool intentionally keeps line-item edits out of scope to avoid accidental stock/total recalculation mistakes.
Args:
order_id (number, required)
status (string, optional): e.g. 'processing', 'completed', 'cancelled', 'refunded'
customer_note, billing, shipping, set_paid (optional)
response_format ('markdown'|'json'): default 'markdown'
Returns: The updated order object.
Examples:
Use when: "mark order 100 as completed" -> order_id=100, status="completed"
Error Handling:
Returns "Error: Resource not found (404)" if order_id doesn't exist.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | No | New order status | |
| billing | No | ||
| order_id | Yes | The numeric WooCommerce order ID to update | |
| set_paid | No | ||
| shipping | No | ||
| customer_note | No | ||
| response_format | No | Output format: 'markdown' for human-readable text or 'json' for machine-readable structured data | markdown |