Delete (soft-delete) an order
Soft-deletes an order in draft or quote status. Returns 409 order_not_deletable
if the order is confirmed, invoiced, or has payments. Use POST /{id}/cancel to cancel
a confirmed or open order. Returns 404 if the order does not belong to the entity.
Requires orders:write scope.
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.
Path Parameters
The order's UUID id or its human-readable order_number (e.g. SO-001234,
INV-0042, Q-2026-0099). UUID lookup uses a direct index and is slightly faster.
order_number lookup resolves within the authenticated entity scope
(Layer 1 enforced -- cross-entity collision impossible).
{
"uuid": {
"value": "550e8400-e29b-41d4-a716-446655440000",
"summary": "UUID lookup (direct index)"
},
"order_number": {
"value": "SO-001234",
"summary": "order_number lookup (polymorphic)"
}
}
