Update a fixed asset

Sparse update. A draft takes every field (the useful life one way only: useful_life_years, useful_life_months or rate_percent, else invalid_useful_life); a registered asset only name, description and serial_number, and any other field is refused with fixed_asset_field_locked. Requires If-Match and Idempotency-Key. Requires the fixed-assets:write OAuth scope.

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

Fields accepted to update a fixed asset. The schema identifies required and optional values.

Sparse update. A draft takes every field; a registered asset only name,
description and serial_number (the app's rule), and any other field is
refused by name.

uuid
string
length ≤ 255
string | null
string | null
integer
≥ 1
date
date | null
number
0.01 to 999999999999
string | null
number | null
0 to 999999999999
integer | null
1 to 100

Useful life in whole years (clears a life in months). Send one of useful_life_years, useful_life_months and rate_percent.

integer | null
12 to 1200

A useful life that is not a whole number of years, in months (12 to 1200; 400 months = 33 years 4 months = 3% a year). Send one of useful_life_years, useful_life_months and rate_percent.

number | null

The useful life as a yearly straight-line rate, in percent of the cost less the residual value (3 = 400 months). It must come to a whole number of months: 7 would be 171.43 months, so send useful_life_months 171 instead. Stored as useful_life_months.

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
*/*