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"
}
}