Cancel a transfer (allowed in draft / pending_approval / approved / submitted)
Cancels a transfer that has not yet shipped. Allowed source statuses:
draft, pending_approval, approved, submitted. Sets status to
cancelled. Returns 404 when the transfer is not found OR when status
is not in the cancellable set (combined guard at the UPDATE clause).
AUDIT-089 fires transfer.cancelled to both entities on intercompany
cancels.
Requires inventory:write scope. Idempotent via Idempotency-Key.
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.
Headers
Client-generated unique key for idempotent POST/PATCH/DELETE operations. Alias for the Idempotency parameter. Max 255 chars. On retry with the same key, the original response is returned without re-executing the operation. Keys expire after 24 hours.
255Path Parameters
Body
Response
Cancelled transfer

