cancel_order
Updated May 21, 20261 min read
Cancel an order via POST /orders/{reference}/cancel. If using partner_order_reference, pass key=partner_order_reference. Use cancel_fulfillment_order_items instead when only selected fulfillment-order quantities should be cancelled.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
order_id | string | Yes | Carriyo order ID or partner_order_reference. |
tenantId | string | Yes | — |
cancellation_reason | string | No | Values: CUSTOMER_CANCELLATION, AUTO_ALLOCATION_FAILED, INVENTORY_OUT_OF_STOCK, STAFF_ERROR, PAYMENT_ISSUE, OTHER. |
key | string | No | Values: order_id, partner_order_reference. |
Example agent prompt
"Cancel the order."
cancel_order( tenantId="…", order_id="ORD-2025-0001" )