finov.ioDocumentationHome

Adjust a fixed asset

API Documentation / Resources / Fixed assets

Adjust a fixed asset

POST /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/fixed-assets/{asset_id}/adjustments

Required OAuth scope: fixedassets:write

Posts a signed cost or accumulated-depreciation adjustment and creates an immutable event linked to the resulting journal.

Adjustment type Effect
cost Changes the asset's capitalized cost.
accumulated_depreciation Changes depreciation recognized to date.

The effective date must be unlocked and cannot precede later asset events.

Parameters

Name In Required Type Description
tenant_id path Yes string (uuid) UUID of the authorized company group.
subsidiary_id path Yes string (uuid) UUID of the subsidiary whose books contain the asset.
asset_id path Yes string (uuid) UUID of a fixed asset.

Request

POST /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/fixed-assets/{asset_id}/adjustments HTTP/1.1
Host: api.finov.io
Authorization: Bearer {access_token}
Content-Type: application/json

{
  "effective_date": "2026-10-31",
  "type": "cost",
  "amount": "250.0000",
  "reason": "Memory upgrade capitalised"
}

Required body fields: effective_date, type, amount, reason.

Responses

Status Description
201 Fixed-asset adjustment posted.
401 Access token is missing, expired, revoked, or invalid.
403 Token lacks the required scope or granted accounting context.
404 Fixed-asset resource does not exist in the granted accounting context.
409 Resource state, period locks, or dependent history prevent the operation.
422 Fixed-asset data, references, or accounting rules failed validation.

201 example

HTTP/1.1 201 Created
Content-Type: application/json

{
  "data": {
    "id": "707b20c1-fab2-4da9-b18b-80ccceae1e72",
    "asset_id": "72a89038-aa5d-4762-9f22-b35aa4d04589",
    "type": "cost",
    "amount": "250.0000",
    "effective_date": "2026-10-31",
    "journal_id": "f58db0d1-d8d5-4663-849a-a931448833e1",
    "created_at": "2026-10-31T18:00:00Z"
  }
}