Register a fixed asset

Registers the draft and posts exactly the previewed journals through the app's own fixed-asset service. Send the preview's confirmation_token, the same Idempotency-Key and the preview's etag as If-Match; if the asset or the calculated journals changed since the preview the answer is 412. Requires the fixed-assets:action OAuth scope.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
Body Params

Confirmed values used to register a fixed asset, including the confirmation token returned by fixedAsset.registerPreview.

date | null

The opening position's date: the last day before the books start (a month end, e.g. 2025-12-31 for books from 1 January 2026) or the books-start date itself (the first day of a month, e.g. 2026-01-01, the date the ledger's opening balance journals carry). The acquisition and the opening accumulated depreciation post on this date against Opening Balance Equity; every later month posts to depreciation expense in its own period, dated its month end.

number | null

Depreciation charged up to the month end before the books start, in the base currency (0 when depreciation starts after it). At most the cost less the residual value.

string
required
length ≤ 8192

The token from the matching preview, sent with the same Idempotency-Key and the preview's etag as If-Match.

Headers
string
required
length ≤ 191

Required unique key whose request hash and terminal response are stored durably for 24 hours.

string

Required. ETag from the latest representation; a stale value returns 412 precondition_failed. Send this header, not the standard If-Match: some HTTP intermediaries evaluate a standard If-Match themselves and can answer 412 even though the change was applied. Never send both; both with different ETags returns 400 conflicting_precondition_headers.

string
deprecated

Accepted with the same value and meaning as Cybooks-If-Match, but do not send it: an intermediary can answer 412 to it after the change was applied. Send Cybooks-If-Match instead.

Responses

Language
Credentials
OAuth2
Missing 1 required scope
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
*/*