Dispose of a fixed asset
Disposes of an asset and posts the disposal journal entry. The JE removes the cost_basis and accumulated_depreciation from the books, records the cash received (if any), and posts the gain or loss on disposal. Disposal methods:
sold: cash exchanged; gain/loss = sale_price minus NBV.scrapped: zero proceeds; full loss equal to NBV.donated: charitable disposition; loss equal to NBV (consult tax adviser for the deductibility position).traded_in: handled as scrapped here; the offsetting acquisition of the replacement asset is a separate createFixedAsset call.
Status transitions to disposed. Subsequent /depreciate calls return
422 ASSET_DISPOSED. Rule 21 enforces GL postability + balance inside
the disposal JE. Idempotent when Idempotency-Key is supplied.
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
Asset disposed (response includes disposal_journal_entry_id and gain_loss_amount)

