Update header-level fields on a draft or submitted transfer
Updates a constrained set of header fields on a transfer in draft or
submitted status. Allowed fields: notes, expected_ship_date,
expected_receive_date, carrier, tracking_number, transfer_notes.
Any other field returns 400 field_not_writable.
Status guard: returns 409 state_transition_invalid when the transfer
is in any status beyond draft or submitted (in_transit / shipped /
receiving / closed / cancelled are immutable at the header level).
Item-level mutations are not supported on PATCH; cancel the transfer and create a new one to change items.
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
Updated transfer header row

