Update Twin Ledger Entry value

This endpoint updates the value of one or more Entries of a Ledger. You can update the value of an Entry in your personal Ledger.

Method	Path	Operation*
PATCH	/twins/{twin}/ledgers/{ledger}/value**	update_twin_ledger_entry_value

*

In order for a user to perform the "update_twin_ledger_entry_value" operation, the "update_twin_ledger_entry_value" permission must be included in the list of allowed actions in the statement of the user's role.

**

The "ledger" parameter in the path of the request should point to the Ledger resource for requests based on the account UUID. Request based on the account UUID can be performed if the Twin rule allows you to perform operations on the given Twin. For requests on personal Ledger, you can use personal instead of the Ledger UUID in the path of the request (/twins/{twin}/ledgers/personal).

Request

Parameter	Type	In	Description
twin required	string	path	Twin UUID.
ledger required**	string	path	Ledger UUID. It must be equal to the UUID of your personal Ledger.
value required	valid JSON data type	body	User-defined value of the Entry. This field can be changed by users only for value type Entries. This field cannot be changed by the user for include and reference type Entries.

*

The "ledger" parameter in the path of the request should point to the Ledger resource for requests based on the account UUID. Request based on the account UUID can be performed if the Twin rule allows you to perform operations on the given Twin. For requests on personal Ledger, you can use personal instead of the Ledger UUID in the path of the request (/twins/{twin}/ledgers/personal).

Response

Entry attributes

Attribute	Type	Description
entry_created_ts	timestamp	Time at which the Entry was created. Measured in seconds (to three decimal places) that have elapsed since the Unix epoch(opens new window).
entry_updated_ts	timestamp	Time at which the "visibility", "history", "timeseries", or "publish" property of an Entry was last updated. Measured in seconds (to three decimal places) that have elapsed since the Unix epoch(opens new window).
value_changed_ts	timestamp	Time at which the value of an Entry was last changed. Measured in seconds (to three decimal places) that have elapsed since the Unix epoch(opens new window).
value	string	User-defined value of the Entry. This field cannot be changed by the user if the "ref" (reference) field exists.

Status codes

Requests to this endpoint result in generic status codes. For a comprehensive list of status codes, please consult the Status codes section.