V3_UtilHistory_Put (Put)
- Last UpdatedNov 06, 2025
- 1 minute read
| Put | V3_UtilHistory_Put |
Resource Path:/api/V3/UtilHistory
| Name | Description |
|---|---|
| trans_id | Used to supply the ID of the transaction if the call is taking part in a transaction. |
The request body is of type Mes.WebApi.Models.V3.Util.UtilEvent.
Required. The property information for the utilization event that is being updated or to optionally merge existing events.
The response body is of type Mes.WebApi.Models.V3.Util.UtilEvent.
OKThe following UtilEvent model properties must have non-null values.
- To identify the entity whose utilization event is being updated: ent_id.
- To identify the utilization event that is being updated by its start time: event_time_utc.
- To provide the updated reason for the utilization event: reas_cd.
- To provide the value of the flag that indicates whether or not the reason is pending and needs to be finalized: reas_pending.
- To provide the code identifying the raw reason that is used to determine the utilization reason: raw_reas_cd.
If the update passes values that are exactly the same as the preceding event, then the events will be merged (the end time of the previous event will be changed to the end time of the supplied event, and the supplied event will be deleted).
Similarly, if the update passes values that are exactly the same as the subsequent event, then the events will be merged (the end time of the supplied event will be changed to the end time of the subsequent event, and the subsequent event will be deleted).