finov.ioDocumentationHome

Roll back a depreciation run

API Documentation / Resources / Fixed assets

Roll back a depreciation run

POST /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/depreciation-runs/{run_id}/rollback

Required OAuth scope: fixedassets:write

Reverses a posted run by creating reversing events and journals. History is retained rather than deleted.

Check Requirement
Run Status is POSTED.
Period Reversal is not blocked by a lock.
Dependencies No later asset event prevents reversal.
Reason Required for the audit record.

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.
run_id path Yes string (uuid) UUID of a depreciation run.

Request

POST /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/depreciation-runs/{run_id}/rollback HTTP/1.1
Host: api.finov.io
Authorization: Bearer {access_token}
Content-Type: application/json

{
  "reason": "Asset opening balances corrected"
}

Required body fields: reason.

Responses

Status Description
200 Depreciation run rolled back.
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.

200 example

HTTP/1.1 200 OK
Content-Type: application/json

{
  "data": {
    "id": "28f174b5-0c7d-42a4-9963-09e29dcbe93d",
    "period": "2026-08",
    "status": "ROLLED_BACK",
    "asset_count": 12,
    "total_depreciation": "6840.0000",
    "posted_at": "2026-08-31T19:00:00Z",
    "rolled_back_at": "2026-09-02T09:00:00Z"
  }
}