# Update a Ledger Entry
This endpoint updates one or multiple Ledger Entries. You can update Ledger Entries:
- In your personal Ledger.
- In a Ledger based on the account UUID. You will only be able to update Entries in a Ledger where your Role allows you to update Entries.
Any optional parameters not provided in the request will be left unchanged.
In order for a user to perform the "update_twin_ledger_entry" operation, the "update_twin_ledger_entry" permission must be included in the list of allowed actions in the statement of the user's role.
|valid JSON data type||body||User-defined value of the Entry. This field cannot be changed by the User if the |
|string||body||Visibility of the Entry. If the |
Any optional parameters not provided in the request will be left unchanged. Any optional parameters provided in the request will replace current parameters.
|entry_created_ts||timestamp||Last time when an Entry in the Ledger was created. Measured in seconds (to three decimal places) that have elapsed since the Unix epoch (opens new window).|
|entry_updated_ts||timestamp||Last time when an Entry in the Ledger was updated. Measured in seconds (to three decimal places) that have elapsed since the Unix epoch (opens new window).|
|value_changed_ts||timestamp||Last time when a value of an Entry in the Ledger was changed. Measured in seconds (to three decimal places) that have elapsed since the Unix epoch (opens new window).|
- Key: alphanumeric string unique within the Ledger. It must match the regular expression (opens new window)
- Value: Valid JSON data type.
|indexes *||list of strings||List of names of Indexes tables. An Indexes table is listed if the Ledger meets the conditions of the Indexes table and is in the Indexes table.|
# Entry attributes
|value||valid JSON data type||User-defined value of the Entry. This field cannot be changed by the User if the |
|visibility||string||Visibility of the Entry. If the |
|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 Entry was last updated. Measured in seconds (to three decimal places) that have elapsed since the Unix epoch (opens new window).|
|string||Time for which the history of changes of the Entry's value is to be stored. If the value of the |
Reference. It allows to create an Entry based on the
|source|| string, composed of ||Source path to the value that we want the Entry to reference.|
|status|| enum, value is || Status of the reference. It can have one of the following values:|
Timeseries attribute. It holds the name of the Timeseries table, the
"measurement" attribute, and (optionally) the
|measurement||string||Name of the measurement column in the given Timeseries table under which the Entry value is to be stored.|
|dimensions||dictionary|| Key-value pair:|
- Key: name of the dimension under which the Entry value is to be stored.
- Value: Value of the given dimension.
You can use the
"timeseries" attribute if the Timeseries service is enabled for your account.
Please note that once you create an Entry where the
"value" is picked up through a
"reference" from another Entry, you cannot update the Entry so that it does not contain a
"reference". In such case, you would need to delete the Entry and create a new Entry without the
# Status codes
Requests to this endpoint result in generic status codes. For a comprehensive list of status codes, please consult the Status Codes section.