Remove a line item from an order
Authorization: requires orders:write API-key scope AND the per-user
orders.edit permission (SoD parity sweep 2026-05-16). System-actor calls
denied per AICPA SoC2 CC6.1.
Removes a line item from an order. Triggers fullRecalculateOrder to recompute totals.
Returns 409 if the item has been partially fulfilled or returned (quantity adjustments
must be made first). Returns 404 if the item does not belong to the specified order.
Requires orders:write scope.
Deleting a line off a CLOSED AR document is blocked the same way as add/update:
cancelled/voided, posted/fulfilled, or paid/billed (suggested_action: revise_order).
To revise a paid order, pass override: true with the orders.revision_override
permission; the delete proceeds and is audited (overpayment/refund routing is unchanged).
Authorizations
API key issued per entity via Settings > Developers > API Keys.
Each key carries scopes (e.g. orders:read, products:write).
Bearer token format: Authorization: Bearer ark_live_ent_Test keys use ark_test_ent_. Both are issued per entity
via Settings > Developers > API Keys.

