split_fulfillment_order

Updated September 22, 20261 min read

Split selected line-item quantities from a fulfillment order via POST /orders/{reference}/fulfillment-orders/{fulfillment_order_id}/split.

Parameters

NameTypeRequiredDescription
fulfillment_order_idstringYesCarriyo fulfillment order ID or partner_fulfillment_order_reference.
line_itemsarrayYesItems to move to the new fulfillment order, by id or product identifier, with quantity.
order_idstringYesCarriyo order ID or partner_order_reference.
tenantIdstringYes—
fulfillment_locationobjectNoLocation for the split-off items. Provide either partner_location_id or partner_location_code. Defaults to the original FO's location.
partner_fulfillment_order_referencestringNo—

Example agent prompt

"Split the fulfillment order."

split_fulfillment_order(
  tenantId="…",
  order_id="ORD-2025-0001",
  fulfillment_order_id="FO-2025-0001",
  line_items=…
)